Bocha AI Web Search MCP Server
2025.03.24
4
TypeScript网页搜索智能摘要中国互联网搜索搜索工具
Bocha AI Web Search MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，专为 Bocha AI 的网页搜索功能设计。该服务器提供强大的搜索工具，能够返回网页内容和相关图片，支持人类可读的 Markdown 输出和原始的 JSON 数据格式。Bocha AI 是一个合法合规的 AI 搜索服务，专注于中国互联网内容的搜索，遵守所有相关的中国法规和标准。
View on GitHub
Overview
基本能力
产品定位
Bocha AI Web Search MCP Server 是一个专注于中国互联网内容搜索的 AI 服务，提供强大的搜索功能和灵活的输出格式。
核心功能
- 网页搜索：检索相关的网页内容、摘要和图片。
- 灵活的时间范围：支持从过去一天到无限时间段的搜索。
- 智能摘要：可选的详细文本摘要功能。
- 双输出格式：
- Markdown：人类可读的格式，包含链接和图片预览。
- JSON：结构化数据，便于程序处理。
- 健壮的错误处理：全面的错误管理，提供清晰的消息。
适用场景
- 需要在中国互联网进行内容搜索的场景。
- 需要灵活输出格式（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 数据
常见问题解答
- 如何获取 Bocha API Key？ 访问 Bocha AI 官网 获取 API Key。
- 如何配置环境变量？
在
.env文件中配置BOCHA_API_KEY。
使用教程
使用依赖
确保已安装 Node.js 和 npm。
安装教程
git clone [email protected]:yoko19191/bocha-ai-mcp-server.git
cd bocha-ai-mcp
cp .env.example .env # 配置你的 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
调试方式
安装完成后，可以通过运行以下命令启动服务并进行调试：
node /ABSOLUTE/PATH/bocha-ai-mcp-server/build/index.js
确保环境变量 BOCHA_API_KEY 已正确设置。