Brave Search MCP

🚀 勇敢搜索 MCP 服務器

這是一個集成了 Brave Search API 的 MCP 服務器，它支持多種搜索功能，包括網頁、本地地點、視頻、圖片和新聞搜索，能為用戶提供多樣化的信息檢索服務。

🚀 快速開始

安裝依賴

• 確保已安裝 Node.js 和 npm。
• 運行 npm install 安裝項目所需的依賴包。

配置環境變量

• 創建 .env 文件並添加以下內容：

API_KEY=your_api_key_here

啟動服務器

• 執行命令 node index.js 或 npm start 啟動 MCP 服務。

調用接口

• 發送請求至 http://localhost:3000/v1/search/{type}，根據需要替換 {type} 為具體的功能模塊 ID。
• 示例：curl http://localhost:3000/v1/search/web?q= Brave Search

✨ 主要特性

• 網頁搜索：通過 Brave Search 進行網頁內容的搜索與檢索。
• 本地地點搜索（POI）：在地圖上查找附近的興趣點，如餐館、酒店等。
• 視頻搜索：通過 YouTube 和 Twitch 等平臺進行視頻內容的搜索與播放。
• 圖片搜索：通過 Google Images 進行圖片資源的搜索與查看。
• 新聞搜索：聚合多個新聞來源，提供即時新聞資訊。

💻 使用示例

基礎用法

以下展示了各個功能模塊的調用參數配置：

網頁搜索 (brave_web_search)

{
  "id": "search#web",
  "name": "網頁搜索",
  "description": "通過 Brave Search 實現網頁內容的搜索。",
  "parameters": [
    {
      "name": "query",
      "type": "string",
      "required": true,
      "description": "要搜索的內容關鍵詞。"
    },
    {
      "name": "count",
      "type": "number",
      "default": 10,
      "description": "返回結果的最大數量（默認為 10）。"
    }
  ]
}

本地地點搜索 (brave_location_search)

{
  "id": "search#location",
  "name": "位置搜索",
  "description": "在地圖上查找附近的興趣點。",
  "parameters": [
    {
      "name": "latitude",
      "type": "number",
      "required": true,
      "description": "搜索的緯度值。"
    },
    {
      "name": "longitude",
      "type": "number",
      "required": true,
      "description": "搜索的經度值。"
    },
    {
      "name": "radius",
      "type": "number",
      "default": 5000,
      "description": "搜索範圍（以米為單位，默認為 5000 米）。"
    }
  ]
}

視頻搜索 (brave_video_search)

{
  "id": "search#video",
  "name": "視頻搜索",
  "description": "通過 YouTube 和 Twitch 進行視頻內容的搜索與播放。",
  "parameters": [
    {
      "name": "query",
      "type": "string",
      "required": true,
      "description": "要搜索的視頻關鍵詞。"
    },
    {
      "name": "platform",
      "type": "string",
      "default": "youtube",
      "description": "指定搜索的平臺（支持 youtube 和 twitch）。"
    }
  ]
}

圖片搜索 (brave_image_search)

{
  "id": "search#image",
  "name": "圖片搜索",
  "description": "通過 Google Images 進行圖片資源的搜索與查看。",
  "parameters": [
    {
      "name": "query",
      "type": "string",
      "required": true,
      "description": "要搜索的圖片關鍵詞。"
    },
    {
      "name": "count",
      "type": "number",
      "default": 10,
      "description": "返回結果的最大數量（默認為 10）。"
    }
  ]
}

新聞搜索 (brave_news_search)

{
  "id": "search#news",
  "name": "新聞搜索",
  "description": "聚合多個新聞來源，提供即時新聞資訊。",
  "parameters": [
    {
      "name": "query",
      "type": "string",
      "required": true,
      "description": "要搜索的新聞關鍵詞。"
    },
    {
      "name": "language",
      "type": "string",
      "default": "zh-CN",
      "description": "指定新聞的語言版本（默認為簡體中文）。"
    }
  ]
}

📚 詳細文檔

注意事項

• API Key：請在項目中配置合法有效的 API Key。
• 數據安全：處理敏感信息時，需做好加密和防護措施。
• 性能優化：根據實際需求調整服務器配置，確保服務穩定運行。

項目結構

brave-search-mcp/
├── index.js          # 主程序入口
├── config/           # 配置文件夾
│   └── keys.js      # API Key 管理
├── services/         # 各功能模塊實現
│   ├── webSearch.js  # 網頁搜索服務
│   ├── location.js  # 位置搜索服務
│   ├── video.js     # 視頻搜索服務
│   ├── image.js     # 圖片搜索服務
│   └── news.js      # 新聞搜索服務
└── package.json      # 項目依賴及腳本配置

📄 許可證

• 開源協議：MIT License
• 版權聲明：版權歸原作者所有，未經授權禁止商業使用。

貢獻指南

歡迎社區貢獻代碼！如發現任何問題或有改進建議，請通過 GitHub 提交 Issues 或 Pull Request。