🚀 勇敢搜索 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 连接将在客户端关闭前保持打开状态。
• 每个搜索结果都会广播给所有连接的客户端。
• 服务器自动处理断开和清理工作。
• 在生产环境中，建议为消息端点实现身份验证。