🚀 博查AI 网络搜索 MCP 服务器
博查AI网络搜索MCP服务器是为博查AI网络搜索功能服务的MCP（模型上下文协议）服务器。它提供强大的搜索工具，能返回网页内容及相关图片，支持人类可读的Markdown输出格式和原始JSON数据格式，为用户带来便捷的搜索体验。
🚀 快速开始
安装说明
确保你已经安装了 Node.js 和 npm。
git clone git@github.com:yoko19191/bocha-ai-mcp-server.git
cd bocha-ai-mcp
cp .env.example .env # 配置你的博查AI 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": ""
}
}
}
}
cursor
env BOCHA_API_KEY=YOUR_BOCHA_API_KEY node /ABSOLUTE/PATH/bocha-ai-mcp-server/build/index.js
✨ 主要特性
- 网页搜索：检索中国互联网的相关网页内容、摘要及相关图片。
- 灵活的时间范围：支持过去一天到无限时间范围内的搜索结果。
- 智能摘要：可选详细文本摘要。
- 双格式输出：
- Markdown：人类可读的格式，包含链接和图片预览。
- JSON：结构化数据，适合程序处理。
- 强大的错误处理：全面的错误管理及清晰的消息提示。
📦 安装指南
确保你已经安装了 Node.js 和 npm，然后按照以下步骤进行安装：
git clone git@github.com:yoko19191/bocha-ai-mcp-server.git
cd bocha-ai-mcp
cp .env.example .env # 配置你的博查AI API 密钥
npm install
npm run build
💻 使用示例
基础用法
使用 bocha_web_search 工具进行搜索。
# 假设在 Python 环境中调用该工具
import requests
# 构建请求参数
params = {
"query": "人工智能",
"freshness": "noLimit",
"summary": false,
"count": 10,
"raw_json": false
}
# 发送请求
response = requests.get('https://your-api-url.com/bocha_web_search', params=params)
# 处理响应
if response.status_code == 200:
print(response.text)
else:
print("请求失败:", response.status_code)
高级用法
在高级场景中，我们可以指定更具体的搜索参数，例如设置搜索时间范围为过去一周，并要求生成详细摘要。
import requests
params = {
"query": "人工智能",
"freshness": "OneWeek",
"summary": true,
"count": 20,
"raw_json": true
}
response = requests.get('https://your-api-url.com/bocha_web_search', params=params)
if response.status_code == 200:
print(response.json())
else:
print("请求失败:", response.status_code)
📚 详细文档
关于博查AI
博查AI (博查AI) 是一个在中国运营的合法且合规的人工智能搜索引擎，专注于为中国互联网内容提供搜索服务。它提供全面的搜索功能，同时严格遵守中国的相关法规和标准。
工具
bocha_web_search
一个强大的网络搜索工具，从中国互联网来源检索内容。
| 属性 | 详情 |
|---|---|
query（必需） |
类型为字符串，是要查找的搜索词。 |
freshness（可选） |
类型为枚举，取值有 "OneDay", "OneWeek", "OneMonth", "OneYear", "noLimit"，默认值为 "noLimit"，用于根据时间筛选结果。 |
summary（可选） |
类型为布尔值，默认值为 false，用于控制是否为搜索结果生成全面的摘要。 |
count（可选） |
类型为数字，范围是 1 - 50，默认值为 10，用于控制返回结果的数量。 |
raw_json（可选） |
类型为布尔值，默认值为 false，当为 false 时，返回人类可读的 Markdown 格式；当为 true 时，返回结构化的 JSON 数据。 |
🔧 技术细节
该项目目前实现了博查 AI 的网络搜索 API 功能。未来的更新将包括：
- AI 搜索：高级语义搜索功能。
- 代理搜索：智能代理搜索功能。
📄 许可证
本项目采用 MIT 许可证。