AgentIndex icon
AgentIndex
工具MCP 服务HOT分类热门最新选型清单对比指南
提交工具
工具MCP 服务HOT分类热门最新选型清单对比指南
首页/
代码助手/
ref-tools-mcp
ref-tools-mcp logo

ref-tools-mcp

活跃·★ 1.2k·MIT·更新于 2026-11-06
★ 必备神器

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 和仓库数据,我们没有实际运行过它。

本文根据项目 README 和公开仓库数据整理,我们没有实际试用过该工具。数据截至 2026-11-10。

许可证
MIT
最新发布
没有 GitHub 发布版本
最近提交
2026-11-06
贡献者
7
复刻数
72
未关闭的 issue 和 PR
13
首次发布
2025-04-22

来源:GitHub、npm 和 PyPI 的公开接口。

#AI 代理#文档检索#Token 效率#上下文管理#模型上下文协议#编程助手#API 工具
$ 安装
$ npx ref-tools-mcp@latest
↗ 访问官网★ GitHub
01

功能特性

01专为AI模型设计的代理式搜索,最大限度地减少上下文使用。
02智能过滤搜索结果,避免在同一会话中重复。
03仅从文档页面提取最相关的部分(最多5k token)。
02

为什么选择它

+专门控制文档上下文的大小:同一会话不重复返回结果,读取页面只返回最相关的约 5k token
+只有搜索和读取网址两个简单工具,可用于 Claude Code、Cursor 等 MCP 客户端
+除公开文档外,还能搜索仓库、PDF 等私有资源
+客户端为 MIT 许可;用 `npx ref-tools-mcp@latest` 安装
03

权衡点

!需要 API 密钥并调用 ref.tools 托管服务,你的查询会发给厂商,不是自包含的
!这个仓库是旧版 stdio 服务器,README 推荐的 HTTP 服务器不在其中
!README 里节省 token 的数字是项目自己的示例记录,不是独立基准测试
!最近一次推送是 2026-10-01
05

维护状况检查

活跃检查日期: 2026-11-10
最近提交
2026-11-06
近 90 天提交数
5
近 90 天发布数
0
最新发布
—
未关闭 issue
13
近期 issue 至少有一条评论的比例
8/10
近 12 周每周提交数
近 12 周每周提交数: 0, 0, 0, 0, 0, 3, 0, 0, 0, 0, 1, 0

最早的一周在左边,最近 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。请打开链接确认该问题是否仍适用于你使用的版本。

04

适合谁

适合选它的情况
  • 你最在意上下文长度:读页面只返回最相关的约 5k token,同一会话里重复搜索不会返回相同结果。
  • 想在 Claude Code、Cursor 或其他 MCP 客户端里用两个简单工具:搜索和读取 URL。
  • 想在搜索公开文档的同时搜索仓库、PDF 等私有资源。
建议换别的情况
  • 你不能把查询发给供应商:它需要 API 密钥和托管的 ref.tools 服务。
  • 你想用推荐的 HTTP 服务器:这个仓库是旧版 stdio 服务器。
  • 你需要独立验证过的 token 节省数据:README 里的数字是项目自己的示例记录。
06

与同类的区别

Context7 logovs Context7★ 65.2k

Context7 解析出库后返回它的文档和示例。Ref 的重点是把返回内容裁到最相关的部分。

完整横向对比 →
07

兼容性

Node.js
运行时
已通过文档验证
ModelContextProtocol
协议
已通过文档验证
AI Coding Tools
集成
已通过文档验证
08

快速开始

1
$ npx ref-tools-mcp@latest
09

使用场景

↳为AI编码代理提供特定的API文档以完成开发任务。
↳使LLM能够迭代地优化搜索查询并理解复杂的编程最佳实践。
↳优化AI代理的上下文以降低推理成本并提高模型准确性。
10

同类工具

⚡热门对决:
VSContext7★65.2k→VSGemini CLI★109.0k→VSOpen Interpreter★68.9k→VSpal-mcp-server★11.8k→
Context7 logo
Context7★ 65.2k
Context7 MCP 为大型语言模型提供最新、版本特定的代码文档和示例,以避免过时或虚假的信息。
VS对比→
Gemini CLI logo
Gemini CLI★ 109.0k
Gemini CLI 是一个开源的 AI 代理,将 Gemini 的强大功能直接带入您的终端,提供轻量级访问,让您的提示能够最直接地到达模型。
VS对比→
Open Interpreter logo
Open Interpreter★ 68.9k
面向终端的编程 Agent,针对低成本和开源模型优化。基于 OpenAI Codex 分叉,可以模拟其他 Agent 运行框架,并在原生沙箱中执行命令。
VS对比→
pal-mcp-server logo
pal-mcp-server★ 11.8k
PAL MCP是一个模型上下文协议服务器,作为AI的提供者抽象层,它将您喜爱的AI工具与多个AI模型连接起来,以实现增强的代码分析、问题解决和协作开发。
VS对比→
Trail-Code logo
Trail-Code★ 11.4k
Trail-Code(原名Graft)通过提供代码库的上下文理解,加速并优化Claude Code、Cursor、Codex、Gemini等编码代理的性能。
VS对比→
zcf logo
zcf★ 6.1k
ZCF提供零配置、一键式部署Claude Code和Codex,支持双语、智能代理系统和个性化AI助手。
VS对比→
claude_code_vs logo
claude_code_vs★ 108
这是一个将Claude Code集成到Visual Studio 2026的扩展,为C#/.NET开发者提供高级AI辅助编程功能。
VS对比→
code-buddy logo
code-buddy★ 51
Code Buddy是一个开源AI编码代理,可在本地机器上免费运行,支持多种LLM提供商。
VS对比→
查看全部替代品 →

收录于以下清单

  • 最新文档与代码上下文 MCP 服务器推荐

评论

登录后发表评论

暂无评论,来发表第一条吧

本页内容
01功能特性02为什么选择它03权衡点05维护状况检查04适合谁06与同类的区别07兼容性08快速开始09使用场景10同类工具
ref-tools /
ref-tools-mcp
↗

MIT 许可的文档检索 MCP 服务器,只返回相关的少量 token,依赖需要 API 密钥的 Ref 托管服务

1.2k72MIT
最后更新2周前
状态活跃
分类代码助手
贡献者7
链接
文档↗讨论↗问题↗版本↗
推荐云部署
Ad

在 DigitalOcean 上一键部署

为你的 MCP 服务、Docker 容器与智能体提供即开即用云服务器,新用户立享 $200 免费额度(60天有效)。

立即领取 $200 免费额度
© 2026 AgentIndex.app|由十年 iOS 开发者构建。
按场景挑选关于我们联系我们广告合作隐私政策使用条款QYSGitHub请作者喝咖啡 ☕

按分类浏览

MCP 服务器代码助手工作流自动化RAG / 知识库多智能体浏览器自动化大模型基础设施开发者工具可观测性

与 Anthropic, OpenAI 或 Microsoft 无关。