MAMA Memory-Augmented MCP Server

使用说明 (Markdown)

• 项目简介
  • MAMA 是一个基于 MCP 的后端服务器框架，负责托管和管理资源（Resources）、注册与执行工具（Tools），并提供并渲染 Prompt 模板（Prompts），以标准化的 JSON-RPC 形式与客户端通信，支持会话管理、能力声明，以及多传输协议（如 Stdio、SSE、WebSocket）。
• 主要功能点
  • 资源与数据访问：集中管理可供 LLM 调用的数据资源与存储。
  • 工具注册与执行：提供可调用的外部功能接口，支持跨进程/插件调用。
  • Prompt 模板与渲染：可定制化提示模板，帮助 LLM 进行上下文渲染与输出控制。
  • JSON-RPC 通信：客户端通过标准的 JSON-RPC 请求/响应进行交互。
  • 会话与能力声明：会话管理、能力披露，以及按需扩展的插件能力。
  • 跨传输协议支持：支持多种传输方式，便于嵌入式 UI、代码编辑器、网关等环境接入。
  • 本地化存储与向量检索：内置嵌入缓存与 SQLite/向量检索能力，提升检索与记忆能力的性能。
  • 集成插件体系：包含 Claude Code 插件、OpenClaw 网关等，方便集成和扩展。
• 安装步骤
  1. 克隆仓库并进入根目录。
  2. 安装依赖并构建全部包（Monorepo 常用工具如 pnpm）：
     • pnpm install
     • pnpm build
  3. 启动 MCP 服务端（服务器端）与相关组件，确保底层数据库与向量检索模块就绪。
  4. 如需 Claude Code/Desktop 的开发集成，按下列流程配置 MCP 服务器对接。
• 服务器配置（供 MCP 客户端使用的连接信息，JSON 描述，非代码）
  • 服务器名称（serverName）：mama
  • 启动命令（command）：npx
  • 参数（args）：["-y", "@jungjaehoon/mama-server"]
  • 注释：这是 Claude Desktop/Code 客户端连接该 MCP 服务器的推荐启动方式，表示通过 npx 运行 Mama 的 MCP 服务器包以建立与 MCP 的通信通道。该配置仅用于客户端连接描述，不属于服务端实现代码的一部分。
• 基本使用方法
  • 启动与接入：开启 MCP 服务后，客户端通过 JSON-RPC 向服务器发起请求（读取资源、执行工具、获取 Prompt 等），服务器返回 JSON-RPC 响应或通知。
  • 会话管理：服务器维护会话状态，确保跨会话的上下文可用性与持续性。
  • 模板与工具扩展：通过插件和工具注册接口扩展新的工具与 Prompt 模板，提升 LLM 的能力边界。
  • 集成与扩展：如需将嵌入向量、图谱等能力接入，请参考核心库（ mémoire-core、Embeddings、Memory Store、Decision Tracker 等）与服务器端中间件的组合使用。