🚀 研究MCP

研究MCP是一个强大的研究工具，它将模型上下文协议（MCP）与Brave Search、Tavily Search等工具相结合，致力于实现类似ChatGPT的DeepResearch功能，为用户提供高效、便捷的研究体验。

🚀 快速开始

本地开发设置

1. 安装 Deno。
2. 克隆仓库。
3. 设置环境变量：
   • BRAVE_API_KEY：Brave Search API 密钥。
   • TAVILY_API_KEY：Tavily Search API 密钥（可选）。
4. 运行应用程序：

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

容器环境设置

1. 安装 Docker 和 Docker Compose。
2. 在 .env 文件中设置环境变量。
3. 构建并运行容器：

   make d-build
   make d-up
   

✨ 主要特性

• 网络搜索：使用 Brave 和 Tavily 搜索 API 通过 Claude Desktop 进行网络搜索。
• MCP 协议：完全符合 Model Context Protocol 标准。
• 缓存机制：搜索结果会被缓存以提升性能并减少 API 调用次数。

📦 安装指南

本地开发

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

Docker 开发

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

💻 使用示例

与 Claude Desktop 的 MCP 集成

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": "你的 Brave API 密钥",
                "TAVILY_API_KEY": "你的 Tavily API 密钥"
            }
        }
    }
}

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

🔧 技术细节

技术栈

已知限制

⚠️ 重要提示

Brave Search API 对非拉丁字符的支持有限。使用日语、汉语、韩语等其他非拉丁字母的语言进行搜索可能会导致编码错误。建议使用英文查询以获得最佳效果。