mcpField
L
libdocs-remote

libdocs-remote

本地服务
github.com/CloudCorpRecords开发工具02 周前更新

关于 libdocs-remote

libdocs-remote 是本地 MCP 服务和命令行工具,将库文档查询转发至 Context7 托管端点。它支持 JSON 与 SSE 响应,并可选使用 API 密钥。

主要功能

  1. 01解析库 ID
  2. 02获取库文档
  3. 03解析 JSON 和 SSE 响应
  4. 04可选 Context7 API 密钥

适用场景

  1. 01查找库对应的 Context7 ID
  2. 02按库 ID 和主题获取文档

MCP 相关

向 MCP 客户端提供 `resolve-library-id` 和 `get-library-docs` 工具,并将请求转发至 Context7 托管 MCP 端点。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"cloudcorprecords-libdocs-remote": {
"command": "npx",
"args": [
"-y",
"@reneturcios/libdocs-remote"
]
}
}
}
启动命令npx -y @reneturcios/libdocs-remote

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@reneturcios/libdocs-remote0.1.0
ocighcr.io/cloudcorprecords/libdocs-remote:0.1.0

工具

2

收录的工具列表 · 更新于 2 周前

参数类型必填说明
libraryNamestring是要解析为兼容 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-idlibraryName(字符串,必填)托管端点返回的匹配库。
get-library-docscontext7CompatibleLibraryID(字符串,必填)、tokens(数字,可选)、topic(字符串,可选)托管端点返回的文档文本。

上游故障——HTTP 错误、JSON-RPC 错误、主机无法访问——会作为工具错误报告,并附上底层错误消息。

开发

npm install
npm run build
npm test
npm run dev

测试完全基于虚假的 fetch 测试样例运行,涵盖普通 JSON 和 SSE 上游响应正文;不会使用网络。

许可证

MIT — 详见 LICENSE。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。