Research Multi API Search

🚀 研究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 對非拉丁字符的支持有限。使用日語、漢語、韓語等其他非拉丁字母的語言進行搜索可能會導致編碼錯誤。建議使用英文查詢以獲得最佳效果。