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,获取本地文档结果
-
安装与运行步骤
- 全局安装 Context 工具
- 使用 npm 安装并全局执行 context 命令
- 构建并添加文档包
- context add <source>,支持本地目录、git 仓库、URL 等
- 启动 MCP 服务器
- context serve
- 配置 MCP 客户端
- 将服务器信息写入客户端的 MCP 配置中,通常使用如下 JSON 形式进行绑定(此处仅描述,不包含具体代码块): { "mcpServers": { "context": { "command": "context", "args": ["serve"] } } }
- 该配置指定服务器名称为 context,启动命令为 context,参数为 serve
- 使用
- 客户端启动后即可通过 get_docs 工具查询本地文档
- 提问示例:对某个库的某类问题,客户端调用 get_docs,传入 library 和 topic,返回本地已索引的文档片段
- 全局安装 Context 工具
-
重要说明
- MCP 客户端并不需要代码实现细节,只需基于上述配置连接到服务器即可
- 服务器端对文档打包、FTS 索引、以及结果聚合有完整实现与单元测试,确保可运行与可扩展