勇敢搜索MCP

Hosted deployment

A hosted deployment is available on Fronteir AI.

Usage with ChatGPT

The Brave Search MCP Server can be used with the web UI of ChatGPT. It takes a few steps.

1. Enable Developer Mode in ChatGPT

Settings → Apps → Advanced settings → Developer mode

Additional instructions here

2. Run the Brave Search MCP in HTTP mode and UI mode

BRAVE_API_KEY="your_key_here" npx -y brave-search-mcp --http --ui

3. Create a local tunnel to expose the MCP Server to ChatGPT

Sign up and configure ngrok, the free plan works.

ngrok http 3001

Take note of the forwarding URL.

...
Forwarding                    https://john-joe-asdf.ngrok-free.dev -> http://localhost:3001
...

4. Add Brave Search MCP as a Connector to ChatGPT

Open ChatGPT Apps settings

Click Apps

Click Create Apps

Fill out the form using the URL from step 3 as the MCP Server URL, but add /mcp.

https://john-joe-asdf.ngrok-free.dev/mcp

For Authentication, select 'No Auth'

Tick the checkbox for 'I understand and want to continue'

Then click Create.

5. Using the Brave Search MCP Server

In the ChatGPT UI, click the '+' button, scroll to '...more', select the newly created Brave Search app, and enter your query.

Usage with Claude Code

For Claude Code users, run this command:

Windows:

claude mcp add-json brave-search '{"command":"cmd","args":["/c","npx","-y","brave-search-mcp"],"env":{"BRAVE_API_KEY":"YOUR_API_KEY_HERE"}}'

Linux/macOS:

claude mcp add-json brave-search '{"command":"npx","args":["-y","brave-search-mcp"],"env":{"BRAVE_API_KEY":"YOUR_API_KEY_HERE"}}'

Replace YOUR_API_KEY_HERE with your actual Brave Search API key.

Usage with Claude Desktop

MCP Bundle (MCPB)

1. Download the mcpb file from the Releases 2. Open it with Claude Desktop or Go to File -> Settings -> Extensions and drag the .mcpb file to the window to install it

Docker

1. Clone the repo
2. Build the image from the repo root

docker build -t brave-search-mcp:latest -f apps/brave-search-mcp/Dockerfile .

1. Run it directly if you want HTTP mode:

docker run --rm -p 3001:3001 -e BRAVE_API_KEY="YOUR_API_KEY_HERE" brave-search-mcp:latest --http

1. Add this to your claude_desktop_config.json for stdio mode:

{
  "mcp-servers": {
    "brave-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRAVE_API_KEY",
        "brave-search-mcp"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR API KEY HERE"
      }
    }
  }
}

NPX

Add this to your claude_desktop_config.json:

{
  "mcp-servers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "brave-search-mcp"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR API KEY HERE"
      }
    }
  }
}

Usage with LibreChat

Add this to librechat.yaml

brave-search:
  command: sh
  args:
    - -c
    - BRAVE_API_KEY=API KEY npx -y brave-search-mcp

Configuration

Environment variables

When running in HTTP mode, the following environment variables are supported:

• BRAVE_API_KEY (required): Brave Search API key.
• PORT (optional): HTTP port (default: 3001).
• HOST (optional): Interface to bind to (default: 0.0.0.0).
• ALLOWED_HOSTS (optional): Comma-separated list of allowed hostnames for Host header validation.
• Example: ALLOWED_HOSTS=localhost,127.0.0.1,my-app.ngrok-free.app
• Use hostnames only (no scheme/path), e.g. my-app.ngrok-free.app not https://my-app.ngrok-free.app/mcp

Examples:

```bash

Getting an API Key

1. Sign up for a Brave Search API account
2. Choose a plan
3. Generate your API key from the developer dashboard