# 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)

## Installation

1. Clone this repository
2. Install dependencies:
   ```bash
   npm install
   ```
3. Copy `.mcp.example.json` to `.mcp.json` and add your Bocha API key:
   ```bash
   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:

```json
{
  "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