Bocha AI Web Search MCP 服务器

一个用于 Bocha AI 网络搜索功能的 MCP (模型上下文协议) 服务器。该服务器提供了一个强大的搜索工具，可以返回网页内容和相关图像，支持人类可读的 Markdown 输出和原始 JSON 数据。

关于 Bocha AI

Bocha AI (博查AI) 是一个在中国境内运营的合法合规的 AI 搜索服务，专门用于搜索中文互联网内容。它提供全面的搜索能力，同时遵守所有相关的中国法规和标准。

功能

• 网络搜索：检索相关的网页内容、摘要和图像
• 灵活的时间范围：从过去一天到无限时间段进行搜索
• 智能摘要：可选的详细文本摘要
• 双重输出格式：
  • Markdown：人类可读的格式，带有链接和图像预览
  • JSON：用于程序化处理的结构化数据
• 强大的错误处理：全面的错误管理，带有清晰的消息

工具

bocha_web_search

一个强大的网络搜索工具，可以从中国互联网来源检索内容。

• query (必需): 搜索关键词

  • 类型: 字符串
  • 描述: 要查找的搜索词

• freshness (可选): 搜索结果的时间范围

  • 类型: 枚举
  • 值: "OneDay", "OneWeek", "OneMonth", "OneYear", "noLimit"
  • 默认: "noLimit"
  • 描述: 按时间段过滤结果

• summary (可选): 启用详细的文本摘要

  • 类型: 布尔值
  • 默认: false
  • 描述: 是否为搜索结果生成全面的摘要

• count (可选): 要返回的结果数量

  • 类型: 数字
  • 范围: 1-50
  • 默认: 10
  • 描述: 控制搜索结果的数量

• raw_json (可选): 返回格式控制

  • 类型: 布尔值
  • 默认: false
  • 描述: 当为 false 时，返回人类可读的 Markdown；当为 true 时，返回结构化的 JSON 数据

设置

请确保您已经安装了 node.js 和 npm。

git clone git@github.com:yoko19191/bocha-ai-mcp-server.git
cd bocha-ai-mcp
cp .env.example .env # 配置您的 Bocha API 密钥
npm install
npm run build

配置

mcp.json

{
  "mcpServers": {
    "bocha-ai-search": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/bocha-ai-mcp-server/build/index.js"
      ],
      "env": {
        "BOCHA_API_KEY": "<YOUR_BOCHA_API_KEY>"
      }
    }
  }
}

cursor

env BOCHA_API_KEY=YOUR_BOCHA_API_KEY node /ABSOLUTE/PATH/bocha-ai-mcp-server/build/index.js

未来工作

该项目目前实现了 Bocha AI 的 Web Search API 功能。未来的更新将包括对以下内容的支持：

• AI 搜索：高级语义搜索功能
• 代理搜索：基于智能代理的搜索功能

许可证

MIT