Chronicle Memory MCP Server

关键词

内存管理上下文持久化JSON-RPC本地记忆AI代理

使用说明（Markdown格式）

项目简介

  • Chronicle 中的 memory_mcp.py 提供一个基于 MCP 协议的服务器端实现，负责对 Falcon AI Agent 的记忆进行持久化管理，并对外暴露记忆相关的工具接口（记忆、回忆、遗忘）。
  • 通过标准的 MCP 流式 JSON-RPC 交互，服务器接收客户端请求并返回响应，支持初始化、列出工具、执行工具等基本能力。

主要功能点

  • MCP 协议核心：实现 initialize、tools/list、tools/call 这几类请求的处理与响应。
  • 工具集成：提供 remember、recall、forget 三个工具，分别用于记忆、检索、删除记忆。
  • 持久化存储：将内存数据保存到本地文件（默认在用户主目录的 .falcon_memory.json），实现跨会话记忆持久化。
  • 本地运行模式：通过标准输入输出（stdin/stdout）与 MCP 客户端通信，适合嵌入到 Claude/MCP 客户端工作流中。
  • 无外部依赖：纯 Python 实现，依赖只有标准库，便于在本地环境快速部署。

安装步骤

  • 确保已安装 Python3 环境。
  • 获取代码：
    • 克隆仓库并定位到 memory MCP 服务器脚本所在位置（路径示例：chronicle/tools/deprecated/memory_mcp.py）。
  • 运行服务器：
    • 在命令行执行：python3 chronicle/tools/deprecated/memory_mcp.py
    • 服务器启动后将通过标准输入/输出等待 MCP 客户端连接并发送请求。

服务器配置（MCP 客户端与 MCP 服务器通信所需的配置信息，JSON 格式，包含 server name、command、args 等） { "serverName": "falcon-memory", "description": "Falcon AI Agent 的本地内存管理 MCP 服务器", "command": "python3", "args": [ "/path/to/chronicle/tools/deprecated/memory_mcp.py" ] } 注释说明：

  • serverName: MCP 客户端使用的服务器名称，需与客户端注册时的一致。
  • command: 启动服务器的命令，一般为 python3。
  • args: 启动命令的参数，包含脚本的路径等必要参数。
  • 以上路径请根据实际部署环境替换，确保客户端能够正确调用服务器。

基本使用方法

  • 启动后，MCP 客户端应发送 initialize 请求，服务器返回版本、服务器信息及能力声明。
  • 客户端可通过 tools/list 请求获取可用工具（remember、recall、forget）的输入输出结构。
  • 使用 tools/call 调用具体工具：
    • remember：保存内容，指定内容与类别（默认类别为 facts）。
    • recall：检索记忆，可按类别检索或取全局条目。
    • forget：删除指定类别中的记忆条目。
  • 记忆数据将持久化到本地 ~/.falcon_memory.json，确保跨会话可用。

关键词 内存管理, 上下文持久化, JSON-RPC, 本地记忆, AI代理

分类ID 6

服务器信息

访问项目