research-mcp

给 AI agent 返回搜索结果与原文，支持 CLI 和 MCP。

English

真实 PR 读取：审查数、行内评论数、文件路径和原评论节选。

快速开始

uvx --from git+https://github.com/bmdy6/research-mcp research-mcp --help
uvx --from git+https://github.com/bmdy6/research-mcp research-mcp search "mcp server" --limit 5
uvx --from git+https://github.com/bmdy6/research-mcp research-mcp fetch \
  https://github.com/cli/cli/pull/14976

MCP 通过 --with "mcp>=1.0,<3" 安装 SDK；详见使用说明。

Claude Code · .mcp.json

{"mcpServers":{"research":{"command":"uvx","args":["--from","git+https://github.com/bmdy6/research-mcp","--with","mcp>=1.0,<3","research-mcp","mcp"]}}}

Codex · .codex/config.toml

[mcp_servers.research]
command = "uvx"
args = ["--from", "git+https://github.com/bmdy6/research-mcp", "--with", "mcp>=1.0,<3", "research-mcp", "mcp"]

Cursor · .cursor/mcp.json

{"mcpServers":{"research":{"command":"uvx","args":["--from","git+https://github.com/bmdy6/research-mcp","--with","mcp>=1.0,<3","research-mcp","mcp"]}}}

Related MCP server: Search MCP Server

你会得到什么

• 一次搜索多个渠道。 GitHub、HN、B站、掘金和 Exa 并发检索，返回来源链接。

• 读取来源而非只看摘要。 网页返回 Markdown，GitHub PR 保留审查、行内评论和分页 coverage。

• 看清读取的边界。 结果标明 partial、失败渠道和截断；B站网页不冒充视频文字稿。

能力与真实输出

以下是 2026-11-09 的真实运行节选，保留原字段名；来源和使用方式见使用说明。网络结果会变化，arXiv 仅在显式指定时启用。

图表项是本地样本实跑，不是在线页面读取成功的证明；只抽取页面内嵌数据，不做图像识别。B站例子只取得网页标题和回退内容，未转写音频。

工作流程

1. 用关键词搜索；--providers 可选 github_search,hacker_news,bilibili,exa,juejin,arxiv。

2. 把候选链接传给 fetch；MCP 的单工具 research_search 同时接受关键词或链接。

3. 检查 status、errors、truncated 和 coverage，再决定是否补搜或翻页。

选项

需要 Python >=3.10；上手命令直接从 main 安装，无需克隆；需 uv 和网络。CLI 无必装 Python 运行依赖，stdio MCP 需可选 [mcp] SDK。

环境变量

外部命令

与 Agent Reach 对比

读取日期 2026-11-09。只比较当前声明和实现，不代表双方所有版本或运行环境。

依据：本包入口、搜索与读取、结果契约，以及 Agent Reach README 固定快照与CLI 实现。

常见问题与限制

能读取哪些地址？ 设计用途是只读公开 HTTPS；HTTP 会先升级为同主机 HTTPS。安全网页链拦截内网、回环和链路本地地址，并逐跳检查重定向；GitHub 走有权限的 gh API，不是匿名公开边界，不要据此部署公共网关。

什么时候开 fake-ip？ 仅在确认可信代理把域名解析到 198.18.0.0/15 时设为 1；这会放宽该特殊非公网网段，错误的 DNS/代理配置可能访问非预期目标。其他私网仍拦截，普通网络不要开启。

为什么搜不到或没有文字稿？ Exa 免费通道会限流，失败不等于不存在；B站转写需要 bili、GROQ_API_KEY 和可下载音频，下载链还可能需要登录/音频依赖。没有 key 时网页回退不保证成功，也不等于视频已读完。

Mac 上 HTTPS 失败怎么办？ python.org 版 Python 先运行安装目录中的 Install Certificates.command；这是 Python 官方安装步骤，不要关闭证书校验。三款客户端的配置均已按原 argv 通过 stdio 工具发现和调用；这不等于 GUI 界面操作已验收。

参与贡献

提交问题时附 Python 版本、命令和脱敏后的错误码；CI 在 Ubuntu/macOS × Python 3.10/3.13 跑离线测试，并单跑可选 MCP stdio。

许可证

MIT。网页及转写内容的权利归原权利人；请遵守上游条款。