What is Bocha Ai Mcp Server

Bocha AI MCP Server is a Model Context Protocol server designed for Bocha AI web search functionality. It provides a powerful tool for retrieving web content and related images, offering both Markdown and JSON output formats.

Use cases

Use cases include conducting legal research, gathering information for compliance purposes, and retrieving relevant web content for various applications in the Chinese market.

How to use

To use the Bocha AI MCP Server, clone the repository, configure your Bocha API key in the .env file, and run the server using Node.js. You can perform searches by sending requests with specific parameters such as keywords, time range, and desired output format.

Key features

Key features include web search capabilities, flexible time range filtering, optional smart summaries, dual output formats (Markdown and JSON), and robust error handling.

Where to use

Bocha AI MCP Server is primarily used in the legal and compliance sectors for searching Chinese internet content, adhering to local regulations.

Bocha AI Web Search MCP Server

An MCP (Model Context Protocol) server for Bocha AI web search functionality. This server provides a powerful search tool that returns web content and related images, supporting both human-readable Markdown output and raw JSON data.

About Bocha AI

Bocha AI (博查AI) is a legal and compliant AI search service operating in the People’s Republic of China(PRC), specifically designed for searching Chinese internet content. It provides comprehensive search capabilities while adhering to all relevant Chinese regulations and standards.

Features

• Web Search: Retrieve relevant web content, summaries, and images
• Flexible Time Range: Search from the past day to unlimited time periods
• Smart Summaries: Optional detailed text summaries
• Dual Output Formats:
  • Markdown: Human-readable format with links and image previews
  • JSON: Structured data for programmatic processing
• Robust Error Handling: Comprehensive error management with clear messages

Tools

bocha_web_search

A powerful web search tool that retrieves content from Chinese internet sources.

• query (required): Search keywords

  • Type: string
  • Description: The search terms to look up

• freshness (optional): Time range for search results

  • Type: enum
  • Values: “OneDay”, “OneWeek”, “OneMonth”, “OneYear”, “noLimit”
  • Default: “noLimit”
  • Description: Filter results by time period

• summary (optional): Enable detailed text summaries

  • Type: boolean
  • Default: false
  • Description: Whether to generate comprehensive summaries for search results

• count (optional): Number of results to return

  • Type: number
  • Range: 1-50
  • Default: 10
  • Description: Control the amount of search results

• raw_json (optional): Return format control

  • Type: boolean
  • Default: false
  • Description: When false, returns human-readable Markdown; when true, returns structured JSON data

Setup

make sure you have node.js and npm install already.

git clone [email protected]:yoko19191/bocha-ai-mcp-server.git
cd bocha-ai-mcp
cp .env.example .env # configure your bocha api key
npm install
npm run build

Configuration

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

FURTURE_WORK

This project currently implements the Web Search API functionality of Bocha AI. Future updates will include support for:

• AI Search: Advanced semantic search capabilities
• Agent Search: Intelligent agent-based search features

License

MIT