Bocha AI Web Search MCP Server
Overview
Bocha AI Web Search MCP Server is an MCP (Model Context Protocol) server designed for Bocha AI's web search functionality, providing a powerful tool for retrieving web content and related images while adhering to Chinese regulations.
To use the server, clone the repository, configure your Bocha API key, and run the server using Node.js. You can perform searches by sending queries to the bocha_web_search tool with various parameters.
- Web Search: Retrieve relevant web content, summaries, and images. - Flexible Time Range: Search results can be filtered by time. - Smart Summaries: Option to generate detailed text summaries. - Dual Output Formats: Supports both Markdown and JSON outputs. - Robust Error Handling: Comprehensive error management with clear messages.
- Searching for legal information on the Chinese internet.
- Retrieving news articles and summaries from various sources.
- Accessing images related to specific search queries.
Add to your AI client
Use these steps to connect Bocha AI Web Search MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"bocha-ai-mcp-server-yoko19191": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-bocha-ai-mcp-server-yoko19191"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"bocha-ai-mcp-server-yoko19191": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-bocha-ai-mcp-server-yoko19191"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"bocha-ai-mcp-server-yoko19191": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-bocha-ai-mcp-server-yoko19191"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"bocha-ai-mcp-server-yoko19191": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-bocha-ai-mcp-server-yoko19191"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"bocha-ai-mcp-server-yoko19191": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-bocha-ai-mcp-server-yoko19191"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"bocha-ai-mcp-server-yoko19191": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-bocha-ai-mcp-server-yoko19191"
]
}
}
}FAQ
Is Bocha AI compliant with local regulations?
Yes, it operates within the legal framework of the People's Republic of China.
What programming language is used?
The server is built using TypeScript.
How can I customize the search results?
You can adjust parameters like freshness, count, and output format to customize your search.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":3565,"uuid":"a63e5203-5a1f-497c-913d-4dcf5abc03a1","name":"bocha-ai-mcp-server","title":"Bocha AI Web Search MCP Server","description":"","avatar_url":"https://avatars.githubusercontent.com/u/15954216?v=4","created_at":"2025-03-20T08:35:51.670Z","updated_at":"2025-03-20T09:01:22.315Z","status":"created","author_name":"yoko19191","author_avatar_url":"https://avatars.githubusercontent.com/u/15954216?v=4","tags":"[]","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/yoko19191/bocha-ai-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"1\",\"license\":\"MIT license\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-24 12:14:34\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]