AgenticMemory MCP 服务器

关键词

记忆图谱跨模型上下文JSON-RPC会话持久化

使用说明（Markdown 要点整理）

  • 项目简介

    • AgenticMemory MCP 服务器是一个基于 MCP 协议的后端服务，能够以 JSON-RPC 的形式向 LLM 客户端提供对记忆图（graph memory）的访问、管理资源、执行工具、获取提示模板，并实现会话管理、跨客户端能力声明和多传输协议支持。
    • 服务器核心通过 Rust 实现，核心组件包括 MCP 协议处理、资源/工具/提示渲染、会话管理、以及对外的传输层（如标准输入/输出 stdio、SSE、WebSocket 等方案）。

  • 主要功能点

    • MCP 协议核心支持：接收 JSON-RPC 2.0 请求，返回标准化的 JSON-RPC 响应，支持初始化握手、工具调用、资源获取、提示获取等基本流程。
    • 资源/工具/ Prompts 的托管与暴露：通过 MCP 路径如 memory://、Prompts、Resources 等向 LLM 提供数据访问能力。
    • 会话管理与持久化：基于一个可移植的二进制图文件(.amem)实现会话上下文、历史追踪、以及跨会话的记忆一致性。
    • 多客户端与跨版本兼容：与 Claude、Cursor、Windsurf、Cody 等多家客户端具备互操作性，在 V3 架构下支持 Immortal Architecture、Ghost Writer 等机制。
    • 多传输协议：当前以 stdio 为核心传输，未来扩展包括 SSE、WebSocket 等远程传输方案（仓库支持相关实现）。
    • 可观测性与部署：提供本地安装脚本、CLI 工具、MCP 服务以及跨平台的部署方案，并包含测试与示例。

  • 安装步骤（简要）

    • 安装前提：需要 Rust 和 Cargo 环境。
    • 构建/安装：
      • cargo install agentic-memory-mcp
      • 或在工作区内构建并运行示例服务器二进制
    • 服务器运行示例（最常用场景，结合仓库说明）：
      • 直接启动服务器：agentic-memory-mcp serve
      • 指定内存文件：memory 指定路径，例如 --memory /path/to/brain.amem
    • 附加组件（可选）：
      • 使用 SSE/HTTP 传输的服务器模式（需要特性开启/依赖支持）
      • 使用 V3 相关工具与 Ghost Writer 等集成（如需要，可开启 corresponding features）

  • 服务器配置（给 MCP 客户端的配置信息） 说明：MCP 客户端需要知道服务器启动命令与标识，以便建立连接。以下是基于仓库信息的正确配置信息模板（JSON）和注释说明。注意，该配置示例仅用于 MCP 客户端的对接描述，实际客户端配置可能在具体工具中以更详细的字段体现，但核心要素应包含服务器名称、启动命令及参数等。

    { "server": "agentic-memory", "command": "agentic-memory-mcp", "args": ["serve"], "memory": "<默认脑文件路径，如 ~/.brain.amem，若需要自定义请设置相应路径>" }

    注释说明：

    • server：服务名称或标识，用于在客户端清单中引用本 MCP 服务。
    • command：启动本 MCP 服务器的可执行名，在本仓库中对应的二进制为 agentic-memory-mcp。
    • args：启动参数，最常用的为 serve，用于以 MCP 服务器模式启动。
    • memory：可选字段，指定默认的内存文件路径，若客户端需要自动接入默认脑记忆请提供。

  • 基本使用方法（简单操作指引）

    • 启动服务器后，确保客户端能检测到该 MCP 服务并建立连接（客户端需要提供上面的启动信息与内存路径）。
    • 客户端发送的典型请求包括：
      • 初始化握手（initialize）
      • 列出工具（tools/list）
      • 调用工具（tools/call，提供 tool name 与参数）
      • 读取资源（resources/read，提供 uri）
      • 获取提示（prompts/get，提供名称和参数）
    • 客户端在握手后可以执行跨客户端的记忆查询、决策追踪、证据收集等操作，并在同一个 memory 文件(.amem) 上进行会话跨模型的持续记忆扩展。
    • 若需要进行本地调试，可直接使用仓库提供的测试与 mock 客户端来模拟 MCP 交互流程。

  • 关键词 记忆图谱, 跨模型上下文, JSON-RPC, 会话持久化, 多客户端

  • 分类ID 6

服务器信息

访问项目