Agent Memory MCP 服务端

使用说明

• 项目简介

  • 这是一个符合 MCP 标准的后端服务器，旨在为多代理 AI 客户端提供“记忆资源、可调用工具、可渲染的提示模板”等能力，并通过 JSON-RPC 风格的 MCP 接口进行通信与协作。核心存储采用 SQLite，支持快速查询、全文检索（FTS5）、以及跨代理的记忆与工作流协同。

• 主要功能点

  • 资源（Resources）：提供 memory:// 当前上下文、agent 行为记录等多种资源的读取能力。资源以易于 LLM 读取的文本/Markdown/JSON 形式渲染给客户端。
  • 工具（Tools）：注册多种工具，覆盖记忆管理（remember、recall、forget、list-memories）、手动工作流（handoff、pickup、complete-handoff）及导入导出等能力，LLM 可以调用这些工具执行外部功能。
  • Prompts（Prompts）：定义和渲染会话模板，例如 session-briefing，帮助 LLM 在不同场景下获得一致、可定制的上下文输入。
  • 会话与权限：内置会话级别的上下文、活动记录、手动工作流的传递与接续等，支持多代理协作。
  • 多传输与接口：通过 MCP 标准对接客户端，理论上可扩展到 Stdio、SSE、WebSocket 等传输方式（依赖实现库能力）。
  • 数据持久化与分析：SQLite+WAL、FTS5 全文检索、索引与触发器确保数据一致性和检索性能。

• 安装步骤

  • 克隆仓库并进入项目目录
  • 运行安装：npm install
  • 启动服务：npm run dev
  • 访问地址（默认/示例端口）: http://localhost:3010/mcp（客户端连接入口）

• 服务器配置（MCP 客户端需要的最小信息）

  • MCP 客户端需要一个配置来知道如何启动并连接 MCP 服务器。以下为示例配置字段及含义（JSON 格式，不含代码块；包含字段注释）：
  • { "serverName": "agent-memory", "command": "npm", "args": ["run", "dev"] // 说明： // - serverName: MCP 服务器在客户端侧的唯一标识名称，建议与实际服务名一致。 // - command: 启动服务器的命令（不包含具体路径，由客户端在本地执行）。 // - args: 启动命令的参数，按照仓库提供的本地启动方式填写。此处使用仓库 README 的本地运行方式：npm run dev。 // - 备注：端口默认为 3010，如需修改，请通过 PORT 或 MCP_URL 环境变量覆盖基础地址；客户端连接时通常会通过 baseUrl 指向 http://localhost:PORT/mcp。 }

• 基本使用方法

  • 启动后，MCP 客户端通过配置将服务器注册到其环境中，随后即可调用内置工具、读取资源和获取 prompts。
  • 常用工作流示例：
    • 让代理记住某个要点（remember），随后让其他代理 recall 这个记忆以实现跨代理协作。
    • 通过 memory://current-context 获取当前项目上下文，作为对话起点。
    • 使用 prompt session-briefing 生成会话初始 briefing，帮助新加入的代理快速对齐上下文。
  • 端点与交互：
    • MCP 请求/响应遵循 JSON-RPC 风格，具体细节由 mcp-use/server 实现层处理。
    • API 端点如 /api/health 提供健康检查（示例：返回已有记忆数等状态信息）。