JinDaGe - bocha-ai-mcp-server MCP Details

article

README

🚀 博查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": "<YOUR_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 许可证。

bocha-ai-mcp-server