MemOS MCP 服务端

关键词

Model Context Protocol资源管理工具执行JSON-RPC本地服务

使用说明

  • 项目简介 MemOS MCP 服务器端是一个符合 MCP 协议的后端服务，负责对资源、工具和提示模板进行管理，并通过 MCP 客户端进行标准化的对话上下文服务。
  • 主要功能点
    1. MCP 服务框架与通信：实现基于 MCP 的服务器端，提供 JSON-RPC 形式的请求/响应处理与工具注册调用。
    2. 工具注册与调用：将多达 20 种 memos_* 工具注册到服务器，LLM 客户端可调用这些工具进行内存管理、搜索、统计、图关系查询等。
    3. 资源与记忆管理：支持对 Memory/MemoryCube 的资源化操作、查询与便捷展示。
    4. Prompt 与模板渲染：提供用于知识图谱、对话上下文等场景的 Prompt 模板及渲染能力，方便 LLM 的交互设计。
    5. 本地化部署与扩展：全部代码在本地运行，默认通过 STDIO 传输方式，后续可扩展到 WebSocket/SSE 等传输协议。
  • 安装步骤
    1. 确保环境搭建：Node.js 版本（建议较新版本）。
    2. 安装依赖：在仓库根目录执行安装命令（如 npm install 或 pnpm install），确保所有依赖就绪。
    3. 启动 MCP 服务器：执行 npm start 或 npx oh-memos-mcp（若已发布到 npm，请按对应命令启动）。服务器启动后将监听 MCP 的 STDIO 传输接口，并进行后台初始化（如 API 就绪检测、cube 注册等）。
    4. 环境变量配置：确保 MEMOS_URL、MEMOS_USER、MEMOS_DEFAULT_CUBE、MEMOS_CUBES_DIR 等环境变量正确配置，MemOS API、记忆 cubes 等服务可以工作。
    5. 客户端连接：向 MCP 服务器发送配置化的请求，使用 JSON-RPC/自定义协议与工具进行交互（下方给出客户端连接配置示例）。
  • 服务器配置（客户端连接信息） 该部分为 MCP 客户端连接的示例配置，客户端不需要在本仓库中书写代码，仅用于描述连接参数。下面的 JSON 描述了服务器名称、启动命令及参数等要点。 { "server": "oh-memos", "command": "npx", "args": ["-y", "oh-memos-mcp"], "env": { "MEMOS_URL": "http://localhost:18000", "MEMOS_USER": "dev_user", "MEMOS_DEFAULT_CUBE": "dev_cube", "MEMOS_CUBES_DIR": "/path/to/oh-memos/data/oh-memos_cubes" }, "notes": [ "这是 MCP 客户端要连接的服务器配置示例。", "服务器默认通过 STDIO 传输进行 MCP 通信，后续可扩展传输协议。", "如需运行，请确保 MemOS API、Neo4j/Qdrant/Ollama 等后端服务就绪。" ] }
  • 基本使用方法
    1. 启动服务器后，确保核心组件就绪（如 MemOS API、图数据库等），服务器日志会提示就绪状态。
    2. 使用 MCP 客户端（如 Claude Code 等）加载上述连接配置，并在对话中通过与 MCP 工具交互实现资源查询、记忆保存、知识图查询等功能。
    3. 调用 memos_save、memos_search、memos_get 等工具，MCP 服务器将返回结构化的 JSON-RPC 响应或文本内容。
    4. 结合 Hooks/模板，可以在编辑、搜索等场景中自动触发内存注入、上下文恢复、以及七层防御等功能，提升对话上下文质量与记忆一致性。

服务器信息

访问项目