ref-tools-mcp
Ref MCP 是一个 Model Context Protocol 服务器,让编程代理能查阅 API、服务和库的文档。README 的卖点是节省 token:上下文越长模型表现越差,token 也要花钱,所以 Ref 想精确找到代理需要的那部分上下文。它提供两个工具。`ref_search_documentation` 搜索网页和 GitHub 上的公开文档,也能搜索仓库、PDF 等私有资源,查询词应是完整的句子或问题;`ref_read_url` 抓取页面并转成 Markdown。
README 说它利用 MCP 会话来跟踪搜索轨迹。同一会话里重复的相似搜索不会再返回相同结果;读取页面时会根据会话的搜索历史丢掉不太相关的部分,只返回最相关的约 5k token,而不是把一个大文档页面的 2 万多 token 全拉进来。它的示例展示了代理先做一次简短搜索再读取一个页面,并标出每一步的 token 数。
这个仓库放的是旧版 stdio 服务器。README 推荐使用 `https://api.ref.tools/mcp` 的 streamable-HTTP 服务器,需要在 ref.tools 获取 API 密钥;stdio 方式(`npx ref-tools-mcp@latest`)同样需要 `REF_API_KEY`。也就是说搜索本身依赖厂商的托管服务。代码为 MIT 许可,最近一次推送是 2026-10-01。本评测依据 README 和仓库数据,我们没有实际运行过它。
功能特性
为什么选择它
权衡点
维护状况检查
- 最近提交
- 2026-11-06
- 近 90 天提交数
- 5
- 近 90 天发布数
- 0
- 最新发布
- —
- 未关闭 issue
- 13
- 近期 issue 至少有一条评论的比例
- 8/10
最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。
状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #32 Support for adding external document URLs to the index7 条评论 · 2025-10-28
- #10 Is ref-tools-mcp self hostable?3 条评论 · 2025-07-25
- #39 Company invoicing1 条评论 · 2026-02-08
- #60 [read-only MCP health check] handshake incomplete: NO_RESPONSE0 条评论 · 2026-10-11
- #52 ai.smithery/ref-tools-ref-tools-mcp is listed on Fatstack — claim it, or ask us to remove it0 条评论 · 2026-09-14
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
适合谁
- 你最在意上下文长度:读页面只返回最相关的约 5k token,同一会话里重复搜索不会返回相同结果。
- 想在 Claude Code、Cursor 或其他 MCP 客户端里用两个简单工具:搜索和读取 URL。
- 想在搜索公开文档的同时搜索仓库、PDF 等私有资源。
- 你不能把查询发给供应商:它需要 API 密钥和托管的 ref.tools 服务。
- 你想用推荐的 HTTP 服务器:这个仓库是旧版 stdio 服务器。
- 你需要独立验证过的 token 节省数据:README 里的数字是项目自己的示例记录。
与同类的区别
Context7 解析出库后返回它的文档和示例。Ref 的重点是把返回内容裁到最相关的部分。
兼容性
快速开始
使用场景
同类工具
收录于以下清单
评论
暂无评论,来发表第一条吧