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]](/cdn-cgi/l/email-protection):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
