SaveContext MCP 服务器

关键词

本地化存储语义检索会话管理离线部署多工具协作

使用说明内容（Markdown格式）

  • 项目简介

    • SaveContext MCP 服务器是一个基于 MCP 的后端服务，它本地托管会话、资源、工具和提示模板等信息，目标是为大型语言模型提供可扩展、可安全访问的上下文服务，方便编码协作、任务跟踪和知识管理。

  • 主要功能点

    • 会话与资源管理：支持创建、切换、暂停与结束会话；为会话关联项目、路径和通道，方便跨项目的上下文组织。
    • 资源与记忆：持久化记忆、命题/决策/备注等上下文条目，提供快速读写和检索。
    • 工具注册与执行：注册并执行外部工具，支持跨会话共享工具能力。
    • 计划与问题跟踪：集成计划（PRD/规格）、任务和问题的创建、查询、更新与分配。
    • 检点与恢复：支持检查点创建、恢复、分割与合并等操作，便于状态回溯与恢复。
    • 语义搜索与嵌入：本地嵌入缓存与向量检索，具备 Tier 1/Tier 2 的本地语义检索能力，支持 Ollama、HF、Transformers 等 provider（可选配置）。
    • 本地离线与私有化：数据全在本地存储，无需云账户。
    • 多代理协作：支持多工具/多客户端对同一会话的并发协作。

  • 安装步骤

    • 先决条件
      • Bun 运行时
      • Rust 编译的 CLI 工具（sc）用于命令执行桥接
    • 获取源码并编译
      • 将仓库克隆到本地
      • 进入 server 目录，安装依赖并构建
    • 快速运行 MCP 服务器
      • 通过命令行直接启动 MCP 服务器（stdio 传输）
    • 说明
      • 服务器实现使用 Bun 运行时，提供标准的 JSON-RPC 风格与 MCP 客户端对接
      • 服务器会将大多数请求通过桥接模式委派给 Rust CLI（sc）处理，以保持业务逻辑的单一来源

  • 服务器配置（MCP 客户端需要的示例配置信息） 该配置用于 MCP 客户端连接该服务器（不是代码实现，仅提供配置示例与含义）：

    • 服务器名称：savecontext
    • 启动命令（command）：bunx
    • 参数（args）：["@savecontext/mcp"]
    • 说明：客户端需要把上述配置放入自己的 MCP 连接配置中，以便使用标准 MCP 的 stdio 传输与服务器通信。

    具体配置示意（文本描述）：

    • { "mcpServers": { "savecontext": { "command": "bunx", "args": ["@savecontext/mcp"] } } }
    • 注释：这是 MCP 客户端需要的连接信息，包含服务器名称、启动命令以及启动参数；MCP 客户端无需了解服务器内部实现细节。

  • 基本使用方法

    • 启动与连接：在支持 MCP 的工具/环境中配置上述服务器信息后，使用工具的 MCP 连接功能建立与 SaveContext MCP 服务器的通信。
    • 常用操作：通过 MCP 的工具集合，创建会话、保存 context、检索上下文、管理问题与计划、创建与恢复检查点等操作。
    • 运行与维护：该 MCP 服务器默认提供本地存储与嵌入式检索能力，若需要中文文档和本地仪表盘，可结合 README 提供的 dashboard 与 CLI 组件使用。

服务器信息

访问项目