Remembrance Oracle Toolkit MCP Server

使用说明（Markdown 格式）

• 项目简介
  • Remembrance Oracle Toolkit 的 MCP Server 是一个后端服务，遵循 MCP 规范，通过 JSON-RPC 2.0 与 AI 客户端通信，提供三大核心能力：托管与管理 Resources（资源）用于数据访问、注册和执行 Tools（工具）以调用外部功能、定义并渲染 Prompts（提示模板）以渲染 LLM 的对话上下文。服务器端负责会话管理、能力声明，并支持多种传输协议（如 STDIO、WebSocket、SSE），为 LLM 应用提供可扩展的上下文服务框架。
• 主要功能点
  • 资源与数据访问：管理代码片段、模式库等可共享的数据资源，确保 LLM 客户端可按需读取与写入。
  • 工具注册与执行：注册命名的工具，LLM 客户端可通过 JSON-RPC 调用外部功能。
  • Prompt 模板定义与渲染：提供可定制的 Prompt 模板，支持不同交互模式与渲染策略，便于与 LLM 的对话流程对齐。
  • MCP 协议实现：遵循 MCP 的请求/响应格式，使用 JSON-RPC 2.0 实现通信。
  • 会话与能力声明：服务器端维护会话上下文、能力清单与生命周期管理。
  • 多传输协议支持：提供 STDIO、WebSocket、SSE 等传输途径，提升与不同 AI 客户端的适配性。
• 安装步骤
  • 先确保运行环境为 Node.js 22+。
  • 安装 Remembrance Oracle Toolkit（如全局工具或项目本地依赖）。
  • 运行 MCP Server 有两种常用方式：
    • 本地开发/测试：在仓库根目录下执行 CLI 命令启动 MCP 服务器（JSON-RPC 2.0 over stdio）。
    • 生产部署：通过配置环境变量与部署脚本启动服务器，支持端口、认证、日志以及跨节点部署等。
• 服务器配置（供 MCP 客户端在连接前准备） 说明：以下为示例配置字段说明，实际请结合实际部署生成 JSON 配置（纯文本描述，不包含代码块）。
  • serverName: "oracle-mcp"（MCP 服务器实例名称，用于区分多服务器部署）
  • command: "node"（启动命令）
  • args: ["src/mcp/server.js"]（启动参数，指向 MCP 服务器实现入口）
  • description: "MCP 服务实例，暴露 Resources、Tools、Prompts 的 MCP API；支持 JSON-RPC 通信。"
  • transport: "stdio"（默认传输，亦可配置为 "websocket" 或 "sse" 等，如需要跨进程/跨网络）
  • baseDir: "/path/to/.remembrance"（本地存储目录，用于持久化模式、历史等数据）
  • capabilities: ["resources", "tools", "prompts", "session", "versioning"]（服务器能力声明，以帮助客户端发现可用能力）
  • notes: "该配置仅用于 MCP 客户端对接的元数据，实际连接时客户端无需修改服务端实现，只需要知道服务器地址/通道即可。"
• 基本使用方法
  • 启动服务器
    • 在开发环境中，执行 MCP 启动命令，让服务器通过标准输入/输出与客户端对话。
  • 连接与调用
    • MCP 客户端通过 JSON-RPC 2.0 的请求格式发送方法调用，例如读取资源、执行工具、获取 Prompt 等。
  • 客户端交互模式
    • 客户端可基于 MCP 提供的能力声明，选择合适的工具和资源，并按需渲染 Prompt 模板来构造与 LLM 的对话上下文。
  • 部署与监控
    • 使用生产脚本部署，结合健康检查、日志与指标服务实现对 MCP Server 的观测与运维。