适合谁
- 已经在本地维护 Hyperresearch markdown 研究库、希望在其他 MCP 客户端复用同一份笔记的用户
- 需要让桌面 AI 客户端先读本地已有资料再回答，而不是每次重新联网检索的研究者
- 重视资料可移植性（纯 markdown、可入 git、可导出 JSON）的个人研究者或小团队
H
59FMRS · C
Hyperresearch 是一个 MIT 许可的个人开源项目，把研究过程沉淀成可搜索的 markdown 研究库，并提供 stdio MCP 服务器让 Claude Desktop、Cursor 等客户端复用该库。它的价值在于持久、可移植、不锁定：markdown 是事实来源，SQLite 只是可重建的缓存。需要注意的是其项目自述的基准成绩尚未经第三方验证，且官方明确不保证事实准确性，用户仍需自行把关来源与结论。
Hyperresearch 是一个由代理驱动的深度研究知识库。README 说明它把 Claude Code 变成深度研究代理：一条 16 步、按层级自适应的流水线，从单条提示生成带有完整来源溯源的报告，并由对抗式批评者与引用核查环节审核。它读取的每个来源都会写入一个持久的、可搜索的 markdown+SQLite 研究库，后续会话在抓取新内容前先检索已有笔记。该研究库可通过内置 MCP 服务器在 Claude Code 之外使用：安装 hyperresearch[mcp] 后运行 hyperresearch mcp，即以 stdio 通信，共暴露 13 个工具（search_notes、read_note、read_many、list_notes、get_backlinks、get_hubs、vault_status、lint_vault、check_source、list_sources、fetch_url、create_note、update_note），Claude Desktop、Cursor 或其他支持 MCP 的客户端都能操作同一研究库。项目作者与维护者为 jordan-gibbs（个人开源项目），采用 MIT 许可，要求 Python 3.11+（3.11–3.13，3.14 尚未支持）。研究库本身以普通 markdown 加 YAML frontmatter 存储，SQLite 只是可重建的索引，因此不会把用户锁定在工具里。
工具能力
search_notes
在持久研究库中对笔记做全文检索（可选正文检索与语义检索）。
read_note
读取单条笔记的内容。
read_many
批量读取多条笔记。
list_notes
列出研究库中的笔记。
get_backlinks
返回指向某条笔记的反向链接。
get_hubs
返回研究库中连接度最高的笔记。
vault_status
查看研究库的状态信息。
lint_vault
对研究库做健康检查，如断链、缺失标签等。
check_source
检查某个来源的信息。
list_sources
列出研究库中记录或引用的来源。
fetch_url
抓取给定 URL 的内容。
create_note
在研究库中新建笔记。
update_note
更新已有笔记。
安装接入
1) 确保使用 Python 3.11–3.13（3.14 尚未支持）。2) 执行 pip install hyperresearch[mcp] 安装带 MCP 支持的版本。3) 运行 hyperresearch mcp，该命令以 stdio 通信方式启动 MCP 服务器。4) 在 Claude Desktop、Cursor 或其他支持 MCP 的客户端中把 hyperresearch mcp 配置为该服务器命令。README 未提供可直接复制的客户端配置文件内容，请按所用客户端的 MCP 配置格式填写。
claude_desktop_config.json
{
"mcpServers": {
"hyperresearch": {
"command": "hyperresearch",
"args": ["mcp"]
}
}
}
选型与风险
不适合谁
- 希望零配置、只想用 Claude Code 内置技能而不维护本地研究库的用户
- 不能安装 Python 3.11+ 环境或不方便运行本地命令行的用户
- 期待服务器自动保证事实准确性的用户——README 明确说明 lint 只能捕捉结构性失败，事实准确性仍需自行判断
- 需要抓取付费墙后内容但未在本地完成登录的用户
所需权限
- 读取与写入工作目录中的研究库目录（research/notes 等 markdown 文件）
- 创建与重建 SQLite 索引文件；执行 hyperresearch sync 时从 markdown 重建索引
- 通过 fetch_url 等工具发起网络请求抓取外部 URL 内容
- 若启用嵌入功能，则需按配置访问对应嵌入服务提供方（voyage、openai；默认 none 不需要任何 API 密钥）
- 创建笔记与更新笔记所需的本地文件写入权限
风险与副作用
- 抓取到的是不可信的网络内容：README 说明网页正文会被包在 <untrusted-source> 围栏内作为数据处理，客户端侧也应保持同样的处理策略，避免被页面内嵌指令影响
- 写入类工具（create_note、update_note）会直接改动本地研究库文件，误用可能污染笔记集合；建议对研究库使用 git 版本控制以便回滚
- 抓取外部 URL 会把请求暴露给第三方站点，可能泄露正在研究的主题或 IP 信息
- 付费墙与登录站点抓取受站点条款约束，登录会话凭据由用户自行承担保管责任
- README 中关于 DeepResearch-Bench 排行榜与 250+ 来源等说法属于项目自述与前瞻性预测，第三方验证尚未完成，不应据此推断质量
常见排障
- 确认 Python 版本在 3.11–3.13 范围内，3.14 目前不受支持
- 确认已执行 pip install hyperresearch[mcp]，否则 hyperresearch mcp 子命令不可用
- 若客户端连接不上，检查是否以 stdio 方式启动且命令路径在客户端的 PATH 中
- 研究库检索结果异常时，可运行 hyperresearch sync 从 markdown 重建 SQLite 索引（索引是可重建的缓存）
- 库内结构告警可用 lint_vault 或 hyperresearch lint 检查断链、缺失标签与来源连通性问题
- 若语义检索不可用，检查嵌入提供方配置；默认 none 不进行向量检索
使用场景
让 Claude Desktop 或 Cursor 直接检索并阅读既有的 Hyperresearch 研究库笔记
在编写报告或文章前，用 search_notes 与 read_many 批量取回已归档的来源与摘要
通过 create_note / update_note 在 MCP 客户端内持续沉淀新的研究笔记
用 list_sources、check_source 与 lint_vault 巡检来源与库内结构问题
支持客户端
Claude Desktop完整支持
Cursor部分支持