Bocha

MCP server for Bocha Search API, providing web search and AI search capabilities.

Features

• Web Search: Search the web using Bocha Web Search API (default)
• AI Search: Search using Bocha AI Search API with multimodal cards and AI-generated answers (only when specifically requested)

Installation

1. Clone this repository
2. Install dependencies:

   npm install
   

3. Copy .mcp.example.json to .mcp.json and add your Bocha API key:

   cp .mcp.example.json .mcp.json
   

4. Edit .mcp.json and replace YOUR_BOCHA_API_KEY_HERE with your actual API key

Usage

As MCP Server

Add the following to your Claude configuration:

{
  "mcpServers": {
    "bocha-search": {
      "command": "node",
      "args": ["/path/to/bocha-mcp/index.js"],
      "env": {
        "BOCHA_API_KEY": "your_api_key_here"
      }
    }
  }
}

Tools

1. web-search: Search the web using Bocha Web Search API

   • query: Search query (supports natural language)
   • count: Number of results (1-50, default 10)
   • freshness: Time range filter (noLimit, day, week, month, year)
   • summary: Whether to include text summary (default true)

2. ai-search: Search using Bocha AI Search API

   • query: Search query
   • count: Number of results (1-50, default 10)
   • freshness: Time range filter (noLimit, day, week, month, year)
   • answer: Whether to generate AI answer (default false)
   • stream: Whether to use streaming response (default false)

Environment Variables

• BOCHA_API_KEY: Your Bocha API key (required)

License

ISC