Repolode
提交项目
ref-tools

ref-tools/ref-tools-mcp

一个 MCP 服务器，让 AI 编程助手以较少的 token 查询公开及私有库的技术文档。

在 GitHub 查看官网
Star
1,184
Fork
72
未关闭 Issue
12
最近提交
昨天

这是什么？

Ref MCP 是一个基于 Model Context Protocol 的服务器，让 AI 编程工具和智能体能够搜索并阅读 API、服务和库的文档。它提供搜索工具，接受完整句子形式的查询，可返回公开网页、GitHub 以及代码仓库、PDF 等私有资料中的相关结果；另有读取工具，可抓取指定 URL 并转换为 Markdown。

项目的重点是控制智能体的上下文长度。在同一个 MCP 会话中，它会记录之前的搜索，避免重复返回相同结果；阅读长页面时，会根据搜索历史去掉相关性较低的部分，尽量只返回约 5k token 的最相关内容，而不是整页内容。

服务器既可以通过推荐的 streamable-http 托管端点接入，也可以通过 npx 以 stdio 方式在本地运行。此外，它还提供了与 OpenAI deep research 客户端兼容的工具命名。

核心功能

  • 01通过单一搜索工具查询公开网页、GitHub 及私有文档资料。
  • 02同一会话中已返回的结果不会重复出现。
  • 03将 URL 转换为 Markdown，并裁剪为最相关的部分。
  • 04同时支持 streamable-http 和本地 stdio 两种连接方式。
  • 05提供与 OpenAI deep research 兼容的工具命名。

适用场景

  • 让编程智能体在编写集成代码时查询最新的 API 接口。
  • 让智能体访问私有内部库的文档或代码仓库。
  • 减少智能体阅读长文档时的 token 消耗与无关内容。

快速上手

  1. 1

    在 ref.tools 注册以获取 API 密钥

  2. 2

    将 stdio 服务器添加到你的 MCP 客户端配置中，使用 npx 运行并设置 REF_API_KEY

    npx ref-tools-mcp@latest

使用前须知

  • 需要先在 ref.tools 注册并获取 Ref API 密钥。
  • 本仓库包含的是旧版 stdio 服务器；README 推荐使用托管的 streamable-http 服务器。

收录于专题

AI 编程助手与编码 AgentMCP Server 精选静态网站生成器与文档工具

标签

#mcp#coding-agent#documentation#llm#context-window#developer-tools#documentation-tool#mcp-server

常见问题

ref-tools-mcp 是什么？
一个 MCP 服务器，让 AI 编程助手以较少的 token 查询公开及私有库的技术文档。 Ref MCP 是一个基于 Model Context Protocol 的服务器，让 AI 编程工具和智能体能够搜索并阅读 API、服务和库的文档。它提供搜索工具，接受完整句子形式的查询，可返回公开网页、GitHub 以及代码仓库、PDF 等私有资料中的相关结果；另有读取工具，可抓取指定 URL 并转换为 Markdown。
ref-tools-mcp 可以免费使用吗？用的什么许可证？
ref-tools-mcp 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
ref-tools-mcp 还在维护吗？
活跃维护中。ref-tools-mcp 最近一次提交是在 2026年11月6日。
ref-tools-mcp 适合用来做什么？
让编程智能体在编写集成代码时查询最新的 API 接口。 让智能体访问私有内部库的文档或代码仓库。 减少智能体阅读长文档时的 token 消耗与无关内容。
ref-tools-mcp 怎么安装和运行？
在 ref.tools 注册以获取 API 密钥 将 stdio 服务器添加到你的 MCP 客户端配置中，使用 npx 运行并设置 REF_API_KEY: npx ref-tools-mcp@latest
在哪里获取 ref-tools-mcp？
源代码和安装说明在 GitHub 上：https://github.com/ref-tools/ref-tools-mcp

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目