Bocha Ai MCP Server

🚀 博查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

一个强大的网络搜索工具，从中国互联网来源检索内容。

🔧 技术细节

该项目目前实现了博查 AI 的网络搜索 API 功能。未来的更新将包括：

• AI 搜索：高级语义搜索功能。
• 代理搜索：智能代理搜索功能。

📄 许可证

本项目采用 MIT 许可证。