基本能力
产品定位
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。
安装教程
bash
git clone git@github.com:yoko19191/bocha-ai-mcp-server.git
cd bocha-ai-mcp
cp .env.example .env # 配置你的 bocha api key
npm install
npm run build
配置
mcp.json
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
bash
env BOCHA_API_KEY=YOUR_BOCHA_API_KEY node /ABSOLUTE/PATH/bocha-ai-mcp-server/build/index.js
调试方式
安装完成后，可以通过运行以下命令启动服务并进行调试：
bash
node /ABSOLUTE/PATH/bocha-ai-mcp-server/build/index.js
确保环境变量 BOCHA_API_KEY 已正确设置。
