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      # 项目依赖及脚本配置

贡献指南

欢迎社区贡献代码！如发现任何问题或有改进建议，请通过 GitHub 提交 Issues 或 Pull Request。

📄 许可证

• 开源协议：MIT License
• 版权声明：版权归原作者所有，未经授权禁止商业使用。