Content
# mcp2brave
A server based on the MCP protocol, utilizing the Brave API to implement web search functionality.
## System Requirements
- Python 3.11+
- UV package manager
- Brave API key
## Installation Steps
1. Clone the project
```bash
git clone <repository_address>
cd mcp2brave
```
2. Create and edit the environment variable file
```bash
# Add your Brave API key to the .env file
.env
```
3. Create a virtual environment using UV
```bash
# Create and activate the virtual environment
uv venv
# For Windows systems use:
.venv\Scripts\activate
# For Linux/Mac systems use:
source .venv/bin/activate
```
4. Install dependencies
```bash
uv sync
```
## Usage
### Install as a Claude extension
```bash
fastmcp install mcp2brave.py
```
### Development Mode and MCP Inspector
To test functionality using the MCP Inspector:
```bash
fastmcp dev mcp2brave.py
```
After running, you can access the MCP Inspector in your browser at: http://localhost:5173
## Available Tools
- `search_web(query: str)`: Search the web using the Brave API
- `search_web_info(query: str)`: Same as above, with a Chinese description
## Environment Variables
- `Brave_API_KEY`: Your Brave API key (required)
## Notes
- Ensure that the API key is correctly set before use
- Related commands can only be run after activating the virtual environment
- If you encounter encoding issues, please ensure your system uses UTF-8 encoding
## Manually Add Cline Continue Claude
Open the MCP server configuration file for Cline Continue Claude and add the following information
```json
"mcp2brave": {
"command": "uv",
"args": [
"run",
"--with",
"fastmcp",
"--with",
"python-dotenv",
"--with",
"beautifulsoup4",
"--with",
"requests",
"fastmcp",
"run",
"C:\\Users\\your_real_path\\mcp2brave.py"
],
"env": {
"BRAVE_API_KEY": "API key"
}
}
```
## Detailed Operation Steps
### Cline Integration

### Cline Integration

### Cline Integration

### Usage Example

Connection Info
You Might Also Like
cc-switch
All-in-One Assistant for Claude Code, Codex & Gemini CLI across platforms.
awesome-mcp-servers
A collection of MCP servers.
git
A Model Context Protocol server for Git automation and interaction.
oh-my-opencode
Background agents · Curated agents like oracle, librarians, frontend...
TrendRadar
TrendRadar: Your hotspot assistant for real news in just 30 seconds.
Appwrite
Build like a team of hundreds