clude-mcp

关键词

内存管理自托管后端JSON-RPCSupabase向量检索
  • 项目简介
    • 这是一个完整的 MCP 服务器实现，使用 Node.js 与 TypeScript 编写，方向是为 LLM 客户端（如 Claude Desktop、Cursor、Antigravity 等）提供可扩展的上下文服务。核心职责包括：托管资源（Resources）、注册并执行工具（Tools）、定义与渲染提示模板（Prompts），以及通过 JSON-RPC 与客户端通信。服务器支持自托管场景（通过 Supabase 作数据库后端、嵌入向量检索等）与托管场景（通过 Cortex/Supabase 提供的云服务接口）。
  • 主要功能点
    • 提供 13 种 MCP 工具（存储、检索、图谱、分析、认知、实用工具）、3 种资源、3 种提示，通过统一的工具/资源/提示注册机制暴露给客户端。
    • 使用 MCP 标准的 JSON-RPC 作为请求/响应协议，支持 ListTools、CallTool、ListResources、ReadResource、ListPrompts、GetPrompt 等能力声明与调用路由。
    • 支持两种运行模式：Hosted（云端 Cortex）与 Self-Hosted（本地 Supabase 存储与向量检索、Anthropic 评分等），通过环境变量进行配置。
    • 提供内存相关能力：存储、检索、记忆图谱、记忆分 decay、梦境循环（dream）、重要性评分（score_importance），以及自定义提示与内存协议（agent_memory_protocol）。
    • 附带本地内存浏览器（http explorer），在指定端口提供 memory explorer UI 与简单 API。
    • 代码结构清晰，分离了脑（brain）、配置、工具、资源、提示等职责，具备单元测试友好性与良好的可维护性。
  • 安装步骤
    1. 克隆仓库并进入项目目录。
    2. 安装依赖并构建：
      • npm install
      • npm run build
    3. 按照 .env.example 配置环境变量（在根目录创建 .env，包含 Hosted 自托管模式所需的凭据，例如 SUPABASE_URL、SUPABASE_KEY、ANTHROPIC_API_KEY、EMBEDDING_PROVIDER、CORTEX_API_KEY 等，以及 MEMORY_TURN_THRESHOLD、MEMORY_IMPORTANCE_THRESHOLD 等阈值）。
    4. 启动服务器：
      • 在生产环境中可直接运行编译后的入口，例如 node dist/index.js（具体命令取决于打包配置）。
      • 也可以在开发模式下使用 npm run dev 进行热编译与调试。
    5. 如需内置内存浏览器，请按 README 中的指示设置 EXPLORER_PORT 并确保本地网络可访问。
  • 服务器配置（MCP 客户端连接所需的最小信息）
    • 配置示例（JSON，需替换为实际路径和名称）： { "server": { "name": "clude", "command": "node", "args": ["/absolute/path/to/clude-mcp/dist/index.js"] } // 注释：server.name 与仓库名称保持一致，command 为启动程序，args 为可执行参数，dist/index.js 路径需为实际构建输出路径 }
    • 说明
      • server.name: MCP 服务器的唯一标识名称，建议与仓库名保持一致，如 "clude"。
      • command: 启动 MCP 服务器的可执行程序，一般为 node。
      • args: 服务器入口的完整执行参数，通常是 dist/index.js 的绝对路径。
  • 基本使用方法
    • 启动后，服务器会在标准输入输出通道（stdin/stdout）暴露 MCP 的 JSON-RPC 接口。客户端需通过该通道向服务器发送请求并解析返回的 JSON-RPC 响应。
    • 主要工作流包括：
      • 使用工具进行内存的存储、检索、图谱连接等操作。
      • 使用资源接口读取当前内存的健康状态、最近记忆等视图。
      • 使用提示接口获取系统提示、对话上下文块等模板文本。
    • 可选的本地内存浏览器（explorer）提供可视化界面，用于查看内存、统计信息与图谱结构。
    • 它支持两种工作模式：
      • hosted：通过 Cortex 云端能力提供存储、嵌入、推理等能力（需要 CORTEX_API_KEY 等配置）。
      • self-hosted：通过 Supabase 作为数据库后端、Anthropic 进行评分与梦境等操作（需要 SUPABASE_URL、SUPABASE_KEY、ANTHROPIC_API_KEY 等）。
  • 依赖与配置要点
    • 需要在环境变量中设置 SUPABASE_URL、SUPABASE_KEY（Self-Hosted 情况下）、ANTHROPIC_API_KEY（用于评分/梦境等）、EMBEDDING_PROVIDER 及相应的 VOYAGE_API_KEY/OPENAI_API_KEY（若启用向量检索）、CORTEX_API_KEY（Hosted 模式）。
    • MEMORY_TURN_THRESHOLD 与 MEMORY_IMPORTANCE_THRESHOLD 会被 agent_memory_protocol 动态读取并嵌入协议文本中，用于记忆提炼的周期与阈值控制。
    • EXPLORER_PORT 用于开启本地内存浏览器界面（可选）。
  • 关键词 内存管理, 自托管后端, JSON-RPC, Supabase, 向量检索
  • 分类ID 6

服务器信息

访问项目