ResearchMCP

一款结合了模型上下文协议（MCP）与Brave搜索、Tavily搜索等工具的研究工具，旨在实现与ChatGPT的DeepResearch相当的研究能力。

技术栈

• 运行时环境：Deno
• 框架：Hono
• 错误处理：Neverthrow（使用Result<T, E>模式）
• 部署：Docker容器

设置

本地开发

1. 安装Deno

2. 克隆仓库

3. 设置环境变量

   • BRAVE_API_KEY：Brave搜索API密钥
   • TAVILY_API_KEY：Tavily搜索API密钥（可选）

4. 运行应用：

   make dev  # 启动HTTP服务器
   make mcp  # 启动用于Claude桌面的MCP服务器
   

容器环境

1. 安装Docker和Docker Compose

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

3. 构建并运行容器：

   make d-build
   make d-up
   

开发命令

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

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

MCP与Claude桌面集成

1. 运行MCP服务器：make mcp

2. 在Claude桌面中添加一个新的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搜索API对非拉丁字符的支持有限。在日语、汉语、韩语及其他非拉丁文字语言中的搜索可能会因编码错误而失败。为了获得最佳效果，请使用英文查询。

功能

• 网络搜索：通过Claude桌面使用Brave搜索API进行网络搜索
• MCP协议：完全符合模型上下文协议
• 缓存：搜索结果被缓存以提高性能并减少API调用次数