About Bocha AI Web Search MCP Server
Bocha AI Web Search MCP Server connects Bocha AI’s Chinese web search to MCP clients, returning page content, summaries, and related images. Results can be time-filtered and returned as readable Markdown or structured JSON.
Key features
- 01Search Chinese web content
- 02Filter results by time range
- 03Generate detailed text summaries
- 04Return Markdown or JSON
Use cases
- 01Find recent Chinese web pages
- 02Retrieve results with related images
- 03Process structured search data in code
MCP support
The MCP server exposes the bocha_web_search tool to clients for searching Chinese web sources and retrieving page content, summaries, and images.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEBocha 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.