Role1776/mcp-retrieval

这是什么？

核心功能

• 01提供三个只读工具：网页搜索、图片搜索和网页正文抓取。
• 02搜索和抓取无需任何搜索引擎 API Key。
• 03通过可读性解析器提取正文并输出为 Markdown。
• 04模拟浏览器 TLS 指纹，并可选配置轮换代理。
• 05支持 stdio 和 streamable HTTP 两种传输方式。
• 06每一项单独返回状态，部分失败时仍能返回成功的结果。

适用场景

• 为本地 LLM 助手提供实时网页搜索结果，无需购买搜索 API。
• 将网页正文以干净的 Markdown 形式输入模型。
• 让 IDE 智能体在编码时查询文档或最新信息。
• 通过 HTTP 为团队部署共享的检索服务。

快速上手

1. 1

   从源码构建二进制文件（需要 Go 1.25.5+）

   make build
2. 2

   以默认的 stdio 传输方式运行服务器

   ./bin/mcp-retrieval

使用前须知

• !web_scrape 仅处理 HTML，因此 raw.githubusercontent.com 等原始文本或文件链接无法抓取到内容。
• !图片搜索结果的相关性无法保证，可能包含无关图片，需要自行核实。
• !页面以不执行 JavaScript 的方式抓取，客户端渲染的内容无法提取。
• !并行搜索过于频繁可能触发 DuckDuckGo 的机器人验证，导致查询失败直至请求频率下降；可配置代理分散负载。

收录于专题

标签

常见问题

mcp-retrieval 是什么？

一个用 Go 编写的 MCP 服务器，为 LLM 提供网页搜索、图片搜索和网页转 Markdown 抓取，无需 API Key。 mcp-retrieval 是一个用 Go 编写的 Model Context Protocol 服务器，向 Claude Desktop、IDE 智能体等兼容 MCP 的客户端提供三个只读工具：web_search 用于网页搜索，web_search_images 用于图片搜索，web_scrape 用于把网页正文抓取为 Markdown。

mcp-retrieval 可以免费使用吗？用的什么许可证？

mcp-retrieval 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

mcp-retrieval 还在维护吗？

活跃维护中。mcp-retrieval 最近一次提交是在 2026年10月24日。

mcp-retrieval 适合用来做什么？

为本地 LLM 助手提供实时网页搜索结果，无需购买搜索 API。 将网页正文以干净的 Markdown 形式输入模型。 让 IDE 智能体在编码时查询文档或最新信息。 通过 HTTP 为团队部署共享的检索服务。

mcp-retrieval 怎么安装和运行？

从源码构建二进制文件（需要 Go 1.25.5+）: make build 以默认的 stdio 传输方式运行服务器: ./bin/mcp-retrieval

在哪里获取 mcp-retrieval？

源代码和安装说明在 GitHub 上：https://github.com/Role1776/mcp-retrieval