ClaudeMemory MCP 服务器

使用说明（简明要点，便于快速上手）

• 项目简介 ClaudeMemory 中的 MCP 服务器实现了基于 MCP 的后端服务，核心职责是对 Resources（资源/数据访问）、Tools（工具/外部功能注册与执行）以及 Prompts（Prompt 模板的定义与渲染）提供标准化的服务，并通过 JSON-RPC 与客户端通信。

• 主要功能点

  • MCP 核心能力：通过 JSON-RPC 处理请求并返回标准化的响应，支持初始化、资源读取、工具调用、Prompt 获取与渲染等。
  • 资源与记忆管理：本地 SQLite 数据库存储资源、事实、证据及元数据，支持多域（全局与项目）上下文分离。
  • 工具与模板：注册并执行工具，渲染与查询 Prompt 模板，供 LLM 调用与交互。
  • 会话与能力声明：提供会话上下文、能力声明，并支持不同传输协议（如标准输入/输出、SSE、WebSocket 的扩展思路）。
  • MCP 配置友好：服务器配置包括启动命令与参数，便于 MCP 客户端接入。

• 安装步骤

  • 安装 Ruby 环境并安装依赖（通过 Gem 方式获取 claude_memory 及其依赖）。
  • 将 MCP 服务器作为独立进程启动，常见启动命令形式为 claude-memory serve-mcp。

• 服务器配置（给 MCP 客户端的示例，JSON 格式，含 server name、command、args 等） { "server_name": "claude-memory", "command": "claude-memory", "args": ["serve-mcp"] } 说明：

  • server_name：在 MCP 客户端注册时使用的服务器标识，此处对应 claude-memory。
  • command：启动服务器的可执行命令，在本仓库实现中对应的入口程序名称。
  • args：传递给命令的参数，例如用于启动 MCP 服务的子命令或选项（如 "serve-mcp"）。 注：具体实现中 MCP 客户端不需要你直接操作此配置文件，但该格式用于了解服务器暴露的能力与如何启动。

• 基本使用方法

  • 启动服务器后，MCP 客户端通过 JSON-RPC 向服务器发送请求，例如初始化、读取资源、执行工具、获取与渲染 Prompts 等。
  • 客户端可以通过服务器返回的 JSON-RPC 响应来获取上下文、执行结果与见解，进而驱动对话或代码生成等工作流。

• 其他注意

  • 仓库包含大量针对 MCP 的集成测试与工具，确保核心能力覆盖请求/响应、工具调用、记忆检索、Prompts 渲染等场景。
  • 服务器实现强调本地化存储与无外部依赖（SQLite 为主），有助于离线或受控环境下的上下文服务。