关于 libdocs-remote
libdocs-remote 是本地 MCP 服务和命令行工具,将库文档查询转发至 Context7 托管端点。它支持 JSON 与 SSE 响应,并可选使用 API 密钥。
主要功能
- 01解析库 ID
- 02获取库文档
- 03解析 JSON 和 SSE 响应
- 04可选 Context7 API 密钥
适用场景
- 01查找库对应的 Context7 ID
- 02按库 ID 和主题获取文档
MCP 相关
向 MCP 客户端提供 `resolve-library-id` 和 `get-library-docs` 工具,并将请求转发至 Context7 托管 MCP 端点。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
2收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| libraryName | string | 是 | 要解析为兼容 Context7 的库 ID 的库名称。 |
详细介绍
libdocs-remote
libdocs-remote 是 library-docs 查找工具的托管版本。
它不会在本地调用 REST API,而是将每个请求作为 JSON-RPC tools/call 转发到托管的 Context7 远程 MCP 端点 https://mcp.context7.com/mcp,并返回收到的答案。
它既支持普通 JSON 答案,也支持 text/event-stream(SSE)答案,并从 data: 行中读取 JSON-RPC 负载。
当你希望由托管服务完成工作,并且只需要一个本地 stdio 服务(或小型 CLI)作为前端时,可以使用它。
CONTEXT7_API_KEY 为可选项。设置后,它会作为托管端点文档中说明的 CONTEXT7_API_KEY 请求头发送;未设置时,则不会发送该请求头,这不属于错误。
安装
npx @reneturcios/libdocs-remote resolve "next.js"
docker run -i ghcr.io/cloudcorprecords/libdocs-remote
CLI
libdocs-remote resolve "next.js"
libdocs-remote docs /vercel/next.js
libdocs-remote docs /vercel/next.js --topic routing --tokens 20000
libdocs-remote --version
退出代码:0 表示成功,1 表示查找错误,2 表示用法错误。
MCP 服务
npx -y @reneturcios/libdocs-remote mcp
{
"mcpServers": {
"libdocs-remote": {
"command": "npx",
"args": ["-y", "@reneturcios/libdocs-remote", "mcp"],
"env": { "CONTEXT7_API_KEY": "your-key-if-you-have-one" }
}
}
}
env 块为可选项。
工具
| 工具 | 输入 | 返回内容 |
|---|---|---|
resolve-library-id | libraryName(字符串,必填) | 托管端点返回的匹配库。 |
get-library-docs | context7CompatibleLibraryID(字符串,必填)、tokens(数字,可选)、topic(字符串,可选) | 托管端点返回的文档文本。 |
上游故障——HTTP 错误、JSON-RPC 错误、主机无法访问——会作为工具错误报告,并附上底层错误消息。
开发
npm install
npm run build
npm test
npm run dev
测试完全基于虚假的 fetch 测试样例运行,涵盖普通 JSON 和 SSE 上游响应正文;不会使用网络。
许可证
MIT — 详见 LICENSE。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。