Remembrances-MCP 服务端

关键词

SurrealDBGGUF向量嵌入知识库代码索引

使用说明

  • 项目简介
    • Remembrances-MCP 是一个用 Go 编写的 MCP 服务器实现，核心职责是向 AI 客户端提供统一的上下文信息与能力，包括资源存储、工具执行以及提示模板渲染等能力。服务器支持多传输协议（标准输入/输出、MCP Streamable HTTP、HTTP JSON API），并内置对 SurrealDB 的嵌入式或远程存储、记忆层（KV、向量/向量检索、图数据库）以及知识库管理等多种数据结构的支持。
  • 主要功能点
    • MCP 协议核心能力：接收客户端的 JSON-RPC 请求，返回 JSON-RPC 响应和通知。
    • 资源管理与数据访问：长期记忆、向量记忆、知识库文档等资源的增删改查。
    • 工具注册与执行：注册各类工具，LLM 客户端可通过工具调用实现外部功能。
    • Prompt 舞台与渲染：提供可定制的提示模板与上下文渲染能力。
    • 多传输与接入方式：stdio（默认，直接在标准输入输出上进行 MCP 通信）、MCP Streamable HTTP、HTTP JSON API，可同时启用多种传输端口。
    • 存储与嵌入：内置 SurrealDB 的嵌入式或远程模式，提供多层记忆（KV、向量、实体图、KB 文档）及嵌入模型支持（GGUF、Ollama、OpenAI API）。
    • 代码索引与代码监控：代码索引、代码符号提取、基于 Tree-sitter 的代码分析、可选的代码监控与 watcher。
    • KB（知识库）自动化：监控知识库目录，自动分 chunk 保存并对文档进行嵌入、检索与管理。
  • 安装步骤
    • 依赖准备
      • Go 1.20+ 环境
      • SurrealDB（嵌入式或远程）及可选的 GGUF / Ollama / OpenAI 等嵌入模型
    • 构建服务器
      • 运行构建命令将生成可执行文件 remembrances-mcp（默认可通过 make build 或 go build 方式生成，最终可执行文件名如 dist/remembrances-mcp）
    • 启动服务器
      • 通过命令行启动并指定配置文件，或者使用默认配置。服务器支持在启动时指定知识库目录、数据库配置、以及传输选项等。
  • 服务器配置（MCP 客户端无需关注，当前条目仅供参考，实际连接通过 MCP 客户端进行 JSON-RPC 调用）
    • 配置示例（JSON，字段含义解释在注释中）: { "server_name": "remembrances-mcp", "command": "./dist/remembrances-mcp", "args": [ "--config", "/path/to/config.yaml" ], "notes": "server_name 为服务名称，command 指向服务器可执行程序，args 为启动参数；config.yaml 用于运行时配置，若未指定将使用环境变量与默认值。" }
  • 基本使用方法
    • 启动后，MCP 客户端通过 JSON-RPC 收发请求，例如调用工具、读取资源、查询知识库等。
    • 客户端需具备以下能力来与服务器交互：1) 指定正确的传输通道（stdio、HTTP 等），2) 使用 MCP 的工具调用接口进行功能访问，3) 通过存储层与向量/图/KB 等进行数据交互。
    • 常用调试方式：通过服务器输出日志定位问题，HTTP API 模式下可对/mcp/tools、/mcp/tools/call、健康端点进行验证。

服务器信息

访问项目