Bocha AI Web Search MCP Server

Bocha AI 网页搜索 MCP 服务

用于 Bocha AI 网页搜索功能的 MCP（Model Context Protocol）服务。此服务提供强大的搜索工具，可返回网页内容和相关图片，并支持易于阅读的 Markdown 格式和原始 JSON 数据。

关于 Bocha AI

Bocha AI (博查AI) 是一家在中华人民共和国（PRC）运营的合法合规 AI 搜索服务，专为搜索中文互联网内容而设计。它提供全面的搜索能力，并遵守所有相关的中国法规和标准。

功能

• 网页搜索：检索相关网页内容、摘要和图片
• 灵活的时间范围：搜索时间范围从过去一天到不限时段
• 智能摘要：可选生成详细的文本摘要
• 双输出格式：
  • Markdown：易于阅读的格式，包含链接和图片预览
  • JSON：适用于程序处理的结构化数据
• 稳健的错误处理：全面管理错误并提供清晰的消息

工具

bocha_web_search

一款强大的网页搜索工具，可从中文互联网来源检索内容。

• query（必填）：搜索关键词

  • 类型：string
  • 描述：要查找的搜索词

• freshness（可选）：搜索结果的时间范围

  • 类型：enum
  • 值："OneDay"、"OneWeek"、"OneMonth"、"OneYear"、"noLimit"
  • 默认值："noLimit"
  • 描述：按时间范围筛选结果

• summary（可选）：启用详细文本摘要

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

• count（可选）：要返回的结果数量

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

• raw_json（可选）：返回格式控制

  • 类型：boolean
  • 默认值：false
  • 描述：为 false 时返回易于阅读的 Markdown；为 true 时返回结构化 JSON 数据

安装

确保已安装 node.js 和 npm。

git clone [email protected]:yoko19191/bocha-ai-mcp-server.git
cd bocha-ai-mcp
cp .env.example .env # configure your bocha api key
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 的网页搜索 API 功能。未来更新将支持：

• AI 搜索：高级语义搜索能力
• Agent 搜索：基于智能 Agent 的搜索功能

许可证

MIT