Bocha Search MCP Server

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)

Related MCP server: MCP-Bocha

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