MCP Standards: Claude Memory Server

使用说明(简要要点,便于快速理解与落地操作):

  • 项目简介
    • 该仓库实现了一个基于 MCP 规范的服务端组件,旨在为大语言模型客户端提供结构化的上下文服务,包含资源管理、工具注册与执行、以及 Prompt 模板的定义与渲染。
    • 服务器通过 JSON-RPC 方式对外暴露能力:读取资源、执行工具、获取 Prompt、以及其他与上下文相关的功能。
    • 通过插件化模块实现:内存存储、日志审计、CLAUDE.md 的生成/更新、模式提取与学习、以及对 V2 模式的支持与回退机制。
  • 主要功能点
    • MCP 协议核心能力:通过装饰式注册(如 list_tools、call_tool)实现对 MCP 客户端请求的暴露与响应。
    • 资源与工具管理:允许注册、查询、执行工具,以及对知识库的读写(添加 Episode、搜索、最近条目等)。
    • 模板与 Prompt 渲染:提供 CLAUDE.md 的管理与自动生成逻辑,以及将知识库渲染为可读格式的导出。
    • 自学习与学习组件:包含 PatternExtractor、CLAUDE.md 管理、Temporal 图谱等模块,支持学习、模式提取、以及对性能的简单分析。
    • 跨存储与扩展性:内置对 SQLite 与 AgentDB 的混合内存路由,兼容 V1/V2 的迁移路径,具备回退能力。
    • 安全与审计:提供审计日志、访问控制与改动记录的基础框架(Audit 日志、ClauDe.md 更新备份等)。
  • 安装与运行
    • 将代码克隆到本地后,按照仓库的依赖管理方式安装运行环境。
    • 启动服务器通常通过运行服务器入口脚本(例如 run_server.py)来启动 MCP 服务器进程。服务器将通过 MCP 框架向客户端暴露工具、资源和模板等能力。
    • 服务器默认以“stdio”等传输通道对外提供 MCP 能力,客户端通过配置文件以 JSON 配置形式连接服务器(详见下方配置示例)。
  • 服务器配置(客户端配置示例,客户端无需依赖此处代码实现的细节,仅用于理解如何连接) { "server_name": "ClaudeMemoryMCP", "command": "python3", "args": ["run_server.py"], "transport": "stdio", "description": "MCP 服务器端,提供资源、工具与提示模板的统一访问接口", "notes": "客户端需要通过 MCP 客户端的 JSON-RPC 调用接口与此服务器通信,如调用 list_tools、call_tool、get_prompt 等能力。" }
  • 基本使用方法
    • 客户端向 MCP 服务器发送请求,获取可用工具列表(list_tools),并通过 call_tool 调用具体工具以进行知识库操作(如 add_episode、search_episodes、list_recent 等)。
    • 客户端也可以请求 CLAUDE.md 的更新、导出知识结构成 Markdown,或执行生成 AI 标准等自动化任务。
    • 服务器负责安全审计、模式学习、以及将学习结果打通到 CLAUDE.md 的更新流程中,支持 V2 的模式提取与回退。

服务器信息