OpenContext MCP 服务器

使用说明

• 项目简介 OpenContext MCP 服务器是开源项目 uno 安装后可以作为 MCP 服务端，能为 Claude、ChatGPT 等客户端提供上下文记忆、工具执行以及提示管理能力。它在本地以 JSON 存储形式维护上下文（contexts.json）及偏好设置（preferences.json 等），并实现对存储、检索、更新、删除等 MCP 工具的支持。

• 主要功能点

  • MCP 服务器端实现：注册、暴露并实现一组 MCP 工具（如 save_context、recall_context、list_contexts、delete_context、search_contexts、update_context），支持 JSON-RPC 交互。
  • 资源与工具管理：本地化存储上下文条目，按标签筛选、模糊检索、按 ID 删除等。
  • 简易内存与偏好分析集成（依赖 Ollama 模型推理等外部组件，可选启用/禁用）。
  • 与 Claude、CLI、UI 的整合路径：服务器可作为 MCP 服务端被 Claude Code/Claude Desktop 调用，或在开发模式下通过 CLI/UI 访问。
  • 本地持久化存储：上下文、偏好设置等数据保存在 ~/.opencontext/ 及相关目录中。

• 安装步骤

  1. 克隆并安装依赖
     • 需要 Node.js 环境，安装依赖后即可构建/运行。
  2. 启动 MCP 服务器
     • 使用 Node 运行 dist/mcp/index.js（需先编译打包，或在开发模式下直接运行源码）。
  3. 与 MCP 客户端对接
     • 客户端通过 MCP 协议的 JSON-RPC 与该服务器通信，发送工具调用和查询。

• 服务器配置（MCP 客户端使用的配置示例） 服务器名称：opencontext 命令与参数示例（注释以中文描述，便于理解）：

  • server: { "name": "opencontext", "command": "node", "args": ["dist/mcp/index.js"] // 若使用源码脱离打包，请改为 ["src/mcp/index.ts"] 或对应的启动入口 } 说明与可选项：
  • 服务器名称与路径应与实际部署保持一致，以便 MCP 客户端在本地或远端正确定位并启动服务器进程。
  • OPENCONTEXT_STORE_PATH（环境变量）用于自定义 MCP 的上下文存储路径，若不设置默认使用用户主目录下的 .opencontext/contexts.json。
  • 生产环境通常通过 dist/bundle 的入口启动，在开发环境可使用 ts/tsx 直接执行入口（需相应工具支持）。

• 基本使用方法

  • 客户端启动后，通过 MCP 调用 opencontext 的工具（如 save_context/recall_context 等）来进行上下文的存储、检索和管理。
  • 通过 REST/UI/CLI 等辅助组件也可对存储进行查看和维护，但 MCP 服务器核心职责是处理 MCP 请求并返回相应的 JSON-RPC 响应。