Brave MCP Search

🚀 勇敢搜索 MCP 服務器

此項目實現了一個適用於 Brave Search 的 Model Context Protocol (MCP) 服務器，支持與像 Claude 這樣的人工智能助手集成，為智能交互提供了強大的搜索支持。

🚀 快速開始

此項目實現了適用於 Brave Search 的 Model Context Protocol (MCP) 服務器，可與 Claude 等人工智能助手集成，為智能交互提供搜索支持。

📦 安裝指南

通過 Smithery 自動安裝

要使用 Smithery 快速自動安裝 Brave Search MCP 服務器以供 Claude 桌面版使用：

npx -y @smithery/cli install @arben-adm/brave-mcp-search --client claude

手動安裝

1. 克隆倉庫：

git clone https://github.com/your-username/brave-search-mcp.git
cd brave-search-mcp

2. 創建虛擬環境並使用 uv 安裝依賴項：

uv venv
source .venv/bin/activate  # 在 Windows 上，使用：.venv\Scripts\activate
uv pip install -r requirements.txt

3. 設置你的 Brave Search API 密鑰：

export BRAVE_API_KEY=your_api_key_here

在 Windows 上，使用：set BRAVE_API_KEY=your_api_key_here

💻 使用示例

基礎用法

1. 配置 MCP 設置文件（例如 claude_desktop_config.json），使其包含 Brave Search MCP 服務器：

{
    "mcpServers": {
        "brave-search": {
            "command": "uv",
            "args": [
                "--directory",
                "path-to\\mcp-python\\brave-mcp-search\\src",
                "run",
                "server.py"
            ],
            "env": {
                "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY_HERE"
            }
        }
    }
}

將 YOUR_BRAVE_API_KEY_HERE 替換為你的實際 Brave API 密鑰。 2. 通過運行你的 MCP 兼容的人工智能助手並使用更新後的配置，啟動 Brave Search MCP 服務器。 3. 服務器現在已啟動並準備好接受來自 MCP 客戶端的請求。 4. 現在你可以通過調用可用工具，在你的 MCP 兼容人工智能助手（如 Claude）中使用 Brave Search 功能。

📚 詳細文檔

可用工具

該服務器提供兩個主要工具：

1. brave_web_search：使用 Brave Search API 進行網絡搜索。
2. brave_local_search：搜索本地企業和服務位置。 有關工具的詳細信息，請參閱 src/server.py 中的工具文檔字符串。

開發

要對項目進行更改：

1. 根據需要修改 src 目錄中的代碼。
2. 更新 requirements.txt 文件，如果添加或刪除了依賴項：

uv pip freeze > requirements.txt

3. 重新啟動服務器以應用更改。

故障排除

如果你遇到任何問題：

1. 確保你的 Brave API 密鑰已正確設置。
2. 檢查所有依賴項是否已安裝。
3. 驗證你使用的 Python 版本是否兼容。
4. 如果對代碼進行了更改，請確保重新啟動服務器。

📄 許可證

此項目根據 MIT License 授權 - 有關詳細信息，請參閱 LICENSE 文件。