|
| 1 | +# brave MCP Server |
| 2 | + |
| 3 | +Web and local search using Brave's Search API |
| 4 | + |
| 5 | +[What is an MCP Server?](https://www.anthropic.com/news/model-context-protocol) |
| 6 | + |
| 7 | +| <!-- --> | <!-- --> | |
| 8 | +|-----------|---------| |
| 9 | +| **Image Source** | Official Image | |
| 10 | +| **Author** | [modelcontextprotocol](https://github.com/modelcontextprotocol) | |
| 11 | +| **Repository** | https://github.com/modelcontextprotocol/servers | |
| 12 | +| **Dockerfile** | https://github.com/modelcontextprotocol/servers/blob/2025.4.6/src/brave-search/Dockerfile | |
| 13 | +| **Docker Image built by** | Docker Inc. | |
| 14 | +| **Licence** | MIT License | |
| 15 | + |
| 16 | +## Tools Summary |
| 17 | + |
| 18 | + 1. **`brave_local_search`**: Searches for local businesses and places using Brave's Local Search API. Best for queries related to physical locations, businesses, restaurants, services, etc. Returns detailed information including: |
| 19 | +- Business names and addresses |
| 20 | +- Ratings and review counts |
| 21 | +- Phone numbers and opening hours |
| 22 | +Use this when the query implies 'near me' or mentions specific locations. Automatically falls back to web search if no local results are found. |
| 23 | + 1. **`brave_web_search`**: Performs a web search using the Brave Search API, ideal for general queries, news, articles, and online content. Use this for broad information gathering, recent events, or when you need diverse web sources. Supports pagination, content filtering, and freshness controls. Maximum 20 results per request, with offset for pagination. |
| 24 | + |
| 25 | +## Tools |
| 26 | + |
| 27 | +### Tool: **`brave_local_search`** |
| 28 | + |
| 29 | +Searches for local businesses and places using Brave's Local Search API. Best for queries related to physical locations, businesses, restaurants, services, etc. Returns detailed information including: |
| 30 | +- Business names and addresses |
| 31 | +- Ratings and review counts |
| 32 | +- Phone numbers and opening hours |
| 33 | +Use this when the query implies 'near me' or mentions specific locations. Automatically falls back to web search if no local results are found. |
| 34 | + |
| 35 | +| Parameter | Type | Description | |
| 36 | +| - | - | - | |
| 37 | +| `query` | `string` | Local search query (e.g. 'pizza near Central Park') | |
| 38 | +| `count` | `number` *optional* | Number of results (1-20, default 5) | |
| 39 | + |
| 40 | +### Tool: **`brave_web_search`** |
| 41 | + |
| 42 | +Performs a web search using the Brave Search API, ideal for general queries, news, articles, and online content. Use this for broad information gathering, recent events, or when you need diverse web sources. Supports pagination, content filtering, and freshness controls. Maximum 20 results per request, with offset for pagination. |
| 43 | + |
| 44 | +| Parameter | Type | Description | |
| 45 | +| - | - | - | |
| 46 | +| `query` | `string` | Search query (max 400 chars, 50 words) | |
| 47 | +| `count` | `number` *optional* | Number of results (1-20, default 10) | |
| 48 | +| `offset` | `number` *optional* | Pagination offset (max 9, default 0) | |
| 49 | + |
| 50 | +## Use this MCP Server |
| 51 | + |
| 52 | +```json |
| 53 | +{ |
| 54 | + "mcpServers": { |
| 55 | + "brave": { |
| 56 | + "command": "docker", |
| 57 | + "args": [ |
| 58 | + "run", |
| 59 | + "-i", |
| 60 | + "--rm", |
| 61 | + "-e", |
| 62 | + "BRAVE_API_KEY", |
| 63 | + "mcp/brave-search" |
| 64 | + ], |
| 65 | + "env": { |
| 66 | + "BRAVE_API_KEY": "YOUR_API_KEY_HERE" |
| 67 | + } |
| 68 | + } |
| 69 | + } |
| 70 | +} |
| 71 | +``` |
| 72 | + |
| 73 | +[Why is it safer to run MCP Servers with Docker?](https://www.docker.com/blog/the-model-context-protocol-simplifying-building-ai-apps-with-anthropic-claude-desktop-and-docker/) |
| 74 | + |
| 75 | +## Rebuild this image |
| 76 | + |
| 77 | +```console |
| 78 | +docker build -t mcp/brave-search -f src/brave-search/Dockerfile https://github.com/modelcontextprotocol/servers.git#2025.4.6 |
| 79 | +``` |
| 80 | + |
0 commit comments