MemoryLayer MCP Server
使用说明(Markdown 格式)
-
项目简介 MemoryLayer MCP Server 是一个面向 LLM 客户端的后端服务器实现,遵循 Model Context Protocol (MCP) 标准,核心职责是以标准化的 JSON-RPC 形式托管资源、注册与执行工具、以及定义和渲染 Prompt 模板。服务器负责会话管理、能力声明,并支持通过多种传输协议与客户端交互,向 LLM 提供上下文、数据访问能力和可执行外部功能的入口。
-
主要功能点
- 资源管理(Resources):托管并提供对资源的访问能力,便于 LLM 客户端按需读取/写入数据。
- 工具(Tools):注册与执行外部功能,LLM 可以通过工具接口完成外部任务。
- 提示模板(Prompts):定义、渲染和管理可定制的提示模板,支持多种交互模式。
- JSON-RPC 通信:服务器通过 JSON-RPC 接收请求并返回结构化的 JSON-RPC 响应或通知。
- 会话与能力声明:提供会话管理、工作区/上下文的能力声明,便于 LLM 客户端根据能力对接 MCP 服务。
- 多传输协议支持:支持 Stdio、SSE、WebSocket 等传输协议,确保和不同 LLM 客户端的互操作性。
- 安全与扩展性:设计上支持访问控制、可扩展的工具库和自定义的上下文服务。
-
安装步骤
- 获取实现:本仓库包含 MemoryLayer 的服务端实现与 MCP 相关组件(包括 TypeScript 版本的 MCP 服务类型、Python/TS 的服务桥接等)。请按各子项目的文档安装对应模块。
- 安装依赖:根据语言环境安装所需依赖(如 Python 环境的 pip 包、Node/TS 模块等)。
- 启动 MCP 服务:在服务端启动 MCP 服务,确保 MCP 端点暴露给客户端使用。具体启动命令参考各子模块的文档与示例。
- 客户端配置:在客户端配置 MCP 服务器的连接信息与认证信息(通常通过 .mcp.json 等配置文件由客户端读取)。客户端配置要求见下方“服务器配置”,本节不展示具体代码。
-
服务器配置(MCP 客户端需要的配置信息示例,非代码展示) 服务器名称:memorylayer command: npx args: ["@scitrera/memorylayer-mcp-server"] env: { MEMORYLAYER_URL: "http://localhost:61001" // MemoryLayer 服务地址 MEMORYLAYER_API_KEY: "your-api-key" //(如需要)API key,用于服务鉴权 MEMORYLAYER_WORKSPACE_ID: "default" // 默认工作区 }
说明:以上为 MCP 客户端的连接参数示例,客户端需要的具体字段与格式可能因实现版本而异。该配置用于客户端在启动时连接到 MCP 服务器的入口信息,实际使用中请以仓库中提供的 MCP 服务器实现和客户端文档为准。
-
基本使用方法
- 启动 MCP 服务器,并确保 MemoryLayer 服务可用。
- 在客户端配置中指定 MCP 服务器入口(如上配置示例所示),启动后客户端即可通过 MCP 协议向服务器请求资源、调用工具、获取和渲染 prompts。
- 使用方可以在 Claude Code、Cursor、 Claude Desktop 等 MCP 客户端中加载该 MCP 服务器的配置信息,然后通过 MCP 的 JSON-RPC 调用进行交互,例如读取资源、执行工具、获取 Prompts。
- 服务器端负责会话管理、能力声明,以及对来自客户端的各种请求进行处理并返回标准化的 JSON-RPC 响应。