支持 SSE 的 Brave Search MCP

这是一个模型上下文协议 (MCP) 服务器，提供集成了服务器发送事件 (SSE) 的 Brave Search 功能。它可以部署到 Coolify 并用作实时搜索服务。

特性

• 通过 MCP 集成 Brave Search API
• 使用 SSE 的实时搜索结果
• Docker 和 Coolify 就绪
• TypeScript 实现
• Express.js SSE 端点

前提条件

• Brave Search API 密钥
• Node.js 18+
• Docker（用于容器化部署）
• Coolify 实例

本地开发

1. 克隆存储库
2. 创建一个包含您的 Brave API 密钥的 .env 文件：

   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://your-server:3001/sse

SSE 端点提供实时搜索结果。使用 EventSource API 连接到它：

const eventSource = new EventSource('http://your-server:3001/sse');

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

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

消息端点

POST http://your-server:3001/messages
Content-Type: application/json

{
  "query": "your search query",
  "count": 10  // optional, default: 10, max: 20
}

使用此端点触发将广播到所有连接的 SSE 客户端的搜索。

MCP 用法

服务器提供以下 MCP 工具：

• brave_web_search: 使用 Brave Search API 执行 Web 搜索

  {
    query: string;    // 搜索查询
    count?: number;   // 结果数量 (1-20, 默认: 10)
  }
  

错误处理

• 服务器将错误广播到所有连接的 SSE 客户端
• 错误格式如下：

  {
    "type": "error",
    "error": "error message"
  }
  

注意事项

• SSE 连接将保持打开状态，直到客户端关闭它
• 每个搜索结果都会广播到所有连接的客户端
• 服务器自动处理断开连接和清理
• 对于生产部署，请考虑为消息端点实施身份验证