Brave Search SSE

🚀 勇敢搜索 MCP 服務帶 SSE 支持

這是一個提供勇敢搜索功能的模型上下文協議（MCP）服務器，集成了服務器發送事件（SSE）功能。它可以部署到 Coolify 並作為即時搜索服務使用，為用戶提供高效、即時的搜索體驗。

✨ 主要特性

• 🌟 集成 Brave Search API 的 MCP 協議，實現強大的搜索功能。
• ⚡ 通過 SSE 實現即時搜索結果，讓用戶第一時間獲取信息。
• 🐳 支持 Docker 和 Coolify 部署，方便快捷地搭建服務。
• 💪 使用 TypeScript 實現，保證代碼的可維護性和健壯性。
• 📡 Express.js SSE 端點，提供穩定的即時數據傳輸。

📦 安裝指南

先決條件

• 勇敢搜索 API 密鑰
• Node.js 18+ 版本
• Docker（用於容器化部署）
• Coolify 實例

本地開發

1. 克隆倉庫。
2. 創建一個 .env 文件並添加你的 Brave API 密鑰：

   BRAVE_API_KEY=your_api_key_here
   PORT=3001
   

3. 安裝依賴項：

   npm install
   

4. 啟動開發服務器：

   npm run dev
   

Docker 部署

1. 使用 docker-compose 構建並運行：

   docker-compose up --build
   

Coolify 部署

1. 在你的 Coolify 控制檯中，創建一個新的服務。
2. 選擇“從源部署”。
3. 配置如下：
   • 倉庫 URL：你的倉庫 URL
   • 分支：main
   • 構建命令：npm run build
   • 啟動命令：npm start
   • 端口：3001
   • 環境變量：
     • BRAVE_API_KEY=your_api_key_here
     • PORT=3001

💻 使用示例

使用 SSE 集成

SSE 端點

GET http://你的服務器:3001/sse

通過 SSE 端點提供即時搜索結果。使用 EventSource API 連接：

const eventSource = new EventSource('http://你的服務器:3001/sse');

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  // 處理搜索結果
  console.log(data);
};

eventSource.onerror = (error) => {
  console.error('SSE 錯誤:', error);
  eventSource.close();
};

消息端點

POST http://你的服務器:3001/messages
Content-Type: application/json

{
  "query": "你的搜索查詢",
  "count": 10  // 可選， 默認值：10，最大值：20
}

使用此端點觸發搜索，結果將廣播到所有連接的 SSE 客戶端。

MCP 使用

服務器提供以下 MCP 工具：

• brave_web_search：通過 Brave Search API 執行網絡搜索

  {
    query: string;    // 搜索查詢
    count?: number;   // 結果數量（1-20， 默認值：10）
  }
  

🔧 技術細節

錯誤處理

• 服務器將錯誤廣播到所有連接的 SSE 客戶端。
• 錯誤格式如下：

  {
    "type": "error",
    "error": "錯誤信息"
  }
  

⚠️ 重要提示

• SSE 連接將在客戶端關閉前保持打開狀態。
• 每個搜索結果都會廣播給所有連接的客戶端。
• 服務器自動處理斷開和清理工作。
• 在生產環境中，建議為消息端點實現身份驗證。