ResearchMCP

一个研究工具，它将模型上下文协议 (MCP) 与 Brave Search、Tavily Search 等结合起来，以实现与 ChatGPT 的 DeepResearch 相当（或旨在相当）的研究能力。

技术栈

• 运行时: Deno
• 框架: Hono
• 错误处理: Neverthrow (Result<T, E> 模式)
• 部署: Docker 容器

设置

本地开发

1. 安装 Deno

2. 克隆仓库

3. 设置环境变量

   • BRAVE_API_KEY: Brave Search API 密钥
   • TAVILY_API_KEY: Tavily Search API 密钥 (可选)

4. 运行应用程序:

   make dev  # HTTP 服务器
   make mcp  # 用于 Claude Desktop 的 MCP 服务器
   

容器环境

1. 安装 Docker 和 Docker Compose

2. 在 .env 文件中设置环境变量

3. 构建并运行容器:

   make d-build
   make d-up
   

开发命令

# 本地开发
make dev     # 启动带有 watch 模式的 HTTP 服务器
make mcp     # 启动用于 Claude Desktop 的 MCP 服务器
make test    # 运行测试
make lint    # 运行 linter
make format  # 格式化代码
make check   # 类型检查

# Docker 开发
make d-build  # 构建镜像
make d-dev    # 启动带有实时重新加载的容器
make d-up     # 在后台运行
make d-logs   # 查看日志
make d-down   # 停止容器

MCP 与 Claude Desktop 集成

1. 运行 MCP 服务器: make mcp

2. 在 Claude Desktop 中，添加一个新的 MCP 服务器，配置如下:

   {
     "mcpServers": {
       "MCPSearch": {
         "description": "由 Brave, Tavily 等驱动的网页搜索",
         "command": "/absolute/path/to/ResearchMCP/cli.ts",
         "args": [],
         "transport": "stdio",
         "env": {
           "BRAVE_API_KEY": "your_brave_api_key_here",
           "TAVILY_API_KEY": "your_tavily_api_key_here"
         }
       }
     }
   }
   

   将 /absolute/path/to/ResearchMCP/cli.ts 替换为 cli.ts 文件的实际路径。

已知限制

• 语言支持: Brave Search API 对非拉丁字符的支持有限。 使用日语、中文、韩语和其他非拉丁文字语言进行搜索可能会因编码错误而失败。 为了获得最佳效果，请使用英语查询。

功能

• 网页搜索: 通过 Claude Desktop 使用 Brave Search API 搜索网络
• MCP 协议: 完全符合模型上下文协议
• 缓存: 搜索结果被缓存以提高性能并减少 API 调用