← 返回目录

Ref MCP

社区

为编码代理高效检索文档。

GitHub 源仓库 ↗

★ 1.1k Stars 分类 · 开发工具非常热门

55FMRS · C

可靠性

9/20

安全与权限

8/20

维护活跃度

11/20

文档质量

14/20

安装易用性

13/20

资料显示，Ref MCP 专注于面向编码代理的令牌高效文档搜索和 URL 内容读取，支持 Streamable HTTP 与传统 stdio，并需要 API 密钥。

查看 FMRS 评分方法 →

Ref MCP 是一个 Model Context Protocol 服务器，为 AI 编码工具或代理提供公共和私有 API、服务及库文档访问能力。它通过会话搜索轨迹过滤重复结果，并提取页面中最相关的内容，以减少上下文使用。

工具能力

ref_search_documentation

搜索技术文档，可查找公共网页、GitHub 内容以及私有仓库和 PDF 中的相关事实或代码片段。

ref_read_url

获取指定 URL 的内容并转换为 Markdown，适合读取搜索结果中的相关文档页面。

安装接入

推荐使用 Streamable HTTP：连接 https://api.ref.tools/mcp，并提供 API 密钥；也可使用传统 stdio：运行 npx ref-tools-mcp@latest，并通过 REF_API_KEY 环境变量提供 API 密钥。

claude_desktop_config.json

{"Ref":{"command":"npx","args":["ref-tools-mcp@latest"],"env":{"REF_API_KEY":"YOUR_API_KEY"}}}

生成并校验客户端配置

选型与风险

适合谁

需要快速查阅技术文档的 AI 编码代理
希望减少无关文档上下文和令牌消耗的团队
需要访问公共及已授权私有文档资源的用户

不适合谁

不需要文档检索能力的 MCP 客户端工作流
没有 Ref API 密钥的用户
需要通用网页抓取而非文档搜索和读取的场景

所需权限

需要 Ref API 密钥进行身份验证
使用私有资源时，需要相应私有资源的访问授权

风险与副作用

API 密钥属于机密凭据，应避免暴露或提交到共享配置中
检索私有仓库和 PDF 时，代理可能接触这些资源中的内容
页面内容会作为代理上下文输入，结果仍需结合任务进行核验

常见排障

确认 API 密钥有效且已通过 X-Ref-Api-Key、URL 参数或 REF_API_KEY 提供
使用 Streamable HTTP 时检查 https://api.ref.tools/mcp 地址和认证配置
使用 stdio 时确认 npx 可用并安装 ref-tools-mcp@latest
若读取内容不符合预期，先使用 ref_search_documentation 获取相关 URL，再调用 ref_read_url

使用场景

为编码代理查找 API、服务和库的技术文档

先搜索相关文档，再读取特定页面内容

从公共或私有资源中检索事实和代码片段

支持客户端

Cursor完整支持