Context 本地离线文档上下文服务

使用说明内容(Markdown格式)

Context 本地离线文档上下文服务

一个实现 MCP 协议的本地后端,用于为大语言模型(LLM)客户端提供上下文信息和功能。它托管离线文档资源、注册并执行工具(如 get_docs),并通过 MCP 标准向客户端提供 JSON-RPC 风格的请求响应。

  • 主要功能

    • 资源管理:本地离线文档打包成数据库包,供服务器加载与查询
    • 工具注册与执行:暴露 get_docs 工具,允许客户端查询本地文档
    • Prompt/上下文渲染:基于本地文档及查询结果生成可渲染的文本输出
    • 通过 MCP 的多传输协议(此实现使用标准输入/输出传输,方便在 CLI 环境与桌面应用中对接)
    • 服务器端负责会话与能力声明,支持向后兼容的客户端接入
  • 运行与使用要点

    • 先安装并使用 context CLI 构建文档包
    • 通过 context serve 启动 MCP 服务器
    • 客户端(如 Claude Desktop、Cursor 等)通过配置连接到该 MCP 服务器
    • 客户端可调用 get_docs 工具,输入 library 与 topic,获取本地文档结果
  • 安装与运行步骤

    1. 全局安装 Context 工具
      • 使用 npm 安装并全局执行 context 命令
    2. 构建并添加文档包
      • context add <source>,支持本地目录、git 仓库、URL 等
    3. 启动 MCP 服务器
      • context serve
    4. 配置 MCP 客户端
      • 将服务器信息写入客户端的 MCP 配置中,通常使用如下 JSON 形式进行绑定(此处仅描述,不包含具体代码块): { "mcpServers": { "context": { "command": "context", "args": ["serve"] } } }
      • 该配置指定服务器名称为 context,启动命令为 context,参数为 serve
    5. 使用
      • 客户端启动后即可通过 get_docs 工具查询本地文档
      • 提问示例:对某个库的某类问题,客户端调用 get_docs,传入 library 和 topic,返回本地已索引的文档片段
  • 重要说明

    • MCP 客户端并不需要代码实现细节,只需基于上述配置连接到服务器即可
    • 服务器端对文档打包、FTS 索引、以及结果聚合有完整实现与单元测试,确保可运行与可扩展

服务器信息