Memories MCP 服务端

关键词

语义记忆服务工具与资源暴露MCP 服务端LLM 上下文服务工具化内存管理

使用说明（Markdown）

  • 项目简介

    • Memories MCP 服务端是一个基于 MCP 协议的后端组件。它把 Memories 的功能（如资源读写、记忆检索、记忆管理等）以 MCP 工具的形式暴露给大语言模型客户端，便于在对话中动态读取上下文、执行外部操作以及渲染提示模板。

  • 主要功能点

    • 提供 MCP 工具集：memory_search、memory_add、memory_delete、memory_delete_batch、memory_list、memory_delete_by_source、memory_count、memory_stats、memory_is_novel、memory_extract 等。
    • 工具实现：通过对 Memories REST API 的调用，将资源和操作对接到 MCP 客户端，便于 LLM 客户端在对话过程中进行语义检索、存储/更新记忆、批量操作等。
    • 支持与多种 LLM 客户端的集成：Claude Code/Codex/Cursor/Claude Desktop 等客户端均可通过 MCP 与服务器交互。
    • 简单的运行时环境：提供一个服务器进程，便于在本地或容器中启动并被 MCP 客户端发现。
    • 引导性配置：为 MCP 客户端提供示例配置，方便将服务器接入到目标客户端。

  • 安装步骤

    • 进入 MCP 服务器目录并安装依赖：
      • 进入 memories/mcp-server
      • 运行 npm install
    • 启动 MCP 服务器：
      • 运行 node index.js（或等效入口，按实际部署路径执行）
    • 说明：MCP 服务器作为一个守护进程运行，监听并响应 MCP 客户端的请求。服务器会将请求转发到 Memories REST API 并将响应返回给客户端。

  • 服务器配置（MCP 客户端的必选信息）

    • MCP 客户端需要配置一个服务器条目，用，以便启动并连接到 MCP 服务器。配置信息以 JSON 格式提供，包含服务器名称、启动命令以及参数等示例（请按实际环境替换路径与凭证）： { "server_name": "memories", "command": "node", "args": ["/path/to/memories/mcp-server/index.js"], "env": { "MEMORIES_URL": "http://localhost:8900", "MEMORIES_API_KEY": "your-api-key-here" } // 说明 // - MEMORIES_URL 指向 Memories 服务的基地址 // - MEMORIES_API_KEY（可选）用于对 REST API 的鉴权（若开启鉴权） } 注：以上配置仅用于 MCP 客户端的连接信息，实际客户端无需改动此客户端端对服务器的接口细节。

  • 基本使用方法

    • 启动后，MCP 客户端可通过工具调用 Memories 的资源与功能，例如执行 memory_search 以获得相关记忆、使用 memory_add 存储新的记忆、调用 memory_extract 等工具进行会话内抽取等。
    • 客户端在使用时应遵循 MCP 的工具约定，传入相应的参数（如查询文本、权重、阈值等），服务器将返回标准的 JSON-RPC 风格响应。

  • 运行示例（非代码块，仅作配置与调用要点）

    • 运行 MCP 服务器后，确保 MEMORIES_URL 可达，例如 http://localhost:8900。
    • 客户端通过 MCP 调用 memory_search，传入 query、k、hybrid 等参数，服务器转发到 Memories REST API 并返回结果。
    • 如需存储新记忆，调用 memory_add，传入 text 与 source 等字段，服务器将文本向 Memories 端点提交并返回新增记忆的 ID 等信息。

  • 备注

    • 该实现包含一个完整的 MCP 服务器入口（index.js），以及将 MCP 请求映射到 Memories REST API 的工具实现，属于一个可运行、具备核心功能的 MCP 服务器实现。

服务器信息

访问项目