Chronicle Memory MCP 服务器

关键词

本地存储JSON-RPC内存管理AI 辅助持久化

使用说明内容（Markdown格式）

  • 项目简介 Chronicle Memory MCP 服务器是一个简化的 MCP 服务实现，提供最核心的 MCP 功能接口：初始化、工具列表和工具调用。它通过标准输入/输出（Stdio）进行 JSON-RPC 风格的通信，适合作为本地持久化记忆的服务端。代码位于仓库的 tools/deprecated/memory_mcp.py，属于较早实现版本。

  • 主要功能点

    • 初始化握手：提供协议版本、服务器信息与能力声明。
    • 工具列表：暴露内存相关工具（如 remember、recall、forget）的描述、输入结构和用途。
    • 工具调用：根据名称执行具体记忆操作，将结果以 JSON-RPC 返回给客户端。
    • 持久化存储：将内存数据写入本地 JSON 文件，确保跨会话的记忆持续性。
    • 传输模式：通过标准输入输出（Stdio）进行通信，符合 MCP 客户端的基本连接方式。

  • 安装步骤

    1. 确保环境中已安装 Python 3。
    2. 打开仓库，定位 memory MCP 服务脚本：工具位于 tools/deprecated/memory_mcp.py。
    3. 启动服务（在与 MCP 客户端同一工作流中运行，服务器等待来自客户端的 JSON-RPC 请求并返回响应）：
      • 直接运行脚本将使其从标准输入读取请求并将响应输出到标准输出。
    4. 确保客户端能够通过 MCP 协议与该服务器进行交互（发送 initialize、tools/list、tools/call 等请求）。

  • 服务器配置（MCP 客户端所需的启动信息，格式为 JSON，包含 server name、command、args 等） 说明：该服务器脚本位于仓库工具目录的 deprecated 下，请据此路径填写命令参数。 { "server_name": "falcon-memory", "command": "python3", "args": ["path/to/chronicle/tools/deprecated/memory_mcp.py"] } 注释：

    • server_name: MCP 客户端在初始化时对服务器的标识名称，与 README 指示的“falcon-memory”一致。
    • command: 启动命令，使用 Python3 解释器运行脚本。
    • args: 脚本路径，指向 memory_mcp.py 的实际位置（在此仓库中位于 tools/deprecated/memory_mcp.py）。
    • 注意：具体路径需要以运行环境中的实际路径为准，配置仅作客户端对接时的参考。

  • 基本使用方法

    1. 客户端通过 MCP 协议连接到服务器（此实现通过 Stdio 与客户端通信）。
    2. 发送 initialize 请求，获取协议版本、服务器信息与能力信息。
    3. 发送 tools/list 请求，获取支持的工具清单（remember、recall、forget 等及其输入结构）。
    4. 使用 tools/call 请求执行具体操作，例如：
      • 调用 remember 以记忆内容到指定类别（facts、context、tasks）。
      • 调用 recall 检索记忆内容（可按类别过滤、设置返回数量上限）。
      • 调用 forget 删除指定类别中的记忆项。
    5. 服务器将结果以 JSON-RPC 形式返回，客户端根据返回值进行后续处理。

  • 说明与注意

    • 该实现较为简化，专注于内存相关工具的暴露与持久化存储，未覆盖完整的 Resources、Prompts、Prompts 渲染等 MCP 高级能力。
    • 代码处于 deprecated 目录，表明其为早期实现版本，使用时请结合需求评估稳定性与安全性。

服务器信息

访问项目