AgentMemory MCP 服务器

关键词

内存管理知识图谱向量检索服务器端实现工具执行

使用说明

  • 项目简介

    • 该仓库实现了一个完整的 MCP 服务端，用于向客户端提供 Resources、Tools、Prompts 的注册、查询与执行能力，基于 JSON-RPC 的 MCP 通信范式，支持多种传输方式（包括嵌入式和独立服务器模式）。
    • 核心能力包括：管理资源与工具、执行 MCP 调用、提供 Prompts 以及与 iii-engine 的集成以实现会话、存储、检索等功能。

  • 主要功能点

    • 涵盖 18 个 Tools、6 个 Resources、3 个 Prompts，遵循 MCP 规范暴露相应的 List / Get / Call 接口。
    • 提供嵌入式模式（集成在 Claudecode/III 引擎的 MCP 入口中）和 Standalone MCP 服务器模式，支持独立运行或与现有代理/客户端并行工作。
    • 与 Memory、Observations、Sessions、Graph 等模块协同，完成资源读取、工具执行、上下文提示的渲染等工作。
    • 通过 JSON-RPC 风格的通信、HTTP 路由和/或 Standalone 的标准 MCP 协议进行交互，客户端可通过配置指向 MCP 服务端以进行交互。
    • 具备基础的鉴权支持（可通过 AGENTMEMORY_SECRET 开启，客户端需携带 Bearer Token 进行认证）。

  • 安装步骤

    • 下载代码并安装依赖
    • 如要使用嵌入式 MCP：确保已安装并运行后端 iii-engine 相关组件；通过 npm 构建并启动 AgentMemory 后端服务
    • 如要使用独立的 MCP 服务，请运行仓库中的 Standalone MCP（npx agentmemory-mcp）
    • 参考快速起步：本文档包含与 MCP 交互的端点、工具清单及读取方式

  • 服务器配置

    • MCP 客户端通常需要知道服务器地址、客户端名称、以及与服务器对接所需的命令和参数。可参考以下配置示例信息（说明性文本，请按实际环境设定）：
    • 服务端名称：agentmemory
    • 启动命令与参数（用于 MCP 客户端的配置容器化/脚本化对接）
    • 服务器对接示例配置（JSON 结构，供 MCP 客户端读取，不作为代码片段展示）： { "serverName": "agentmemory", "command": "npx", "args": ["agentmemory-mcp"] }
    • 备注：独立 MCP 服务器模式会基于内存KV（InMemoryKV）及可选的持久化配置运行，嵌入模式在集成的环境中直接提供 MCP 服务。

  • 基本使用方法

    • 启动服务后，客户端（如 Claude、Cursor、Windsurf 等）通过 MCP 配置将服务器地址指向本 MCP 服务端。
    • 客户端可通过 MCP 提供的工具、资源和 Prompts 进行查询、执行和渲染，服务器端负责上下文管理、能力声明及跨会话的资源与工具协作。
    • 如需使用独立 MCP，请参考 README 中的 Standalone MCP 使用说明，按需配置持久化路径与端口区间。

  • 额外信息

    • 代码实现覆盖 MCP 的核心职责：资源与工具的注册、执行、Prompts 的获取、以及通过 MCP 端点与客户端的交互。
    • 提供了多种测试用例和示例，确保 MCP 服务端在多客户端场景下的可用性与稳定性。

服务器信息

访问项目