이 프로젝트는 Brave Search의 Model Context Protocol (MCP) 서버를 구현하고 Claude와 같은 AI 조수와 통합 할 수 있습니다.

필수품

• 파이썬 3.11+
• uv - 빠른 파이썬 패키지 설치 및 해결자

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Brave Search MCP 서버를 자동으로 설치하십시오.

수동 설치

1. 저장소를 복제:

2. 가상 환경을 만들고 uv를 사용하여 의존성을 설치하십시오:

3. Brave Search API 열쇠를 설치하십시오:

Windows에서, 사용: set BRAVE_API_KEY=your_api_key_here

사용법

1. MCP 설정 파일 (예를들면, claude_desktop_config.json])을 구성하여 Brave Search MCP 서버를 포함합니다:

실제 Brave API 키로 [T2]를 대체하십시오.

2. 업데이트 된 구성으로 MCP 호환 AI 조수를 실행하여 Brave Search MCP 서버를 시작합니다.

3. 서버는 지금 실행되고 MCP 클라이언트에게서 요구에 응하기 위하여 준비되어 있을 것입니다.

4. 이제 사용할 수 있는 도구를 호출하여 MCP 호환 AI 조수 (클래드와 같은)에서 Brave Search 기능을 사용할 수 있습니다.

사용 가능한 도구

서버는 두 가지 주요 도구를 제공합니다:

1. 명세.

Brave Search MCP Server

This project implements a Model Context Protocol (MCP) server for Brave Search, allowing integration with AI assistants like Claude.

Prerequisites

• Python 3.11+
• uv - A fast Python package installer and resolver

Installation

Installing via Smithery

To install Brave Search MCP server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @arben-adm/brave-mcp-search --client claude

Manual Installation

1. Clone the repository:

   git clone https://github.com/your-username/brave-search-mcp.git
   cd brave-search-mcp
   

2. Create a virtual environment and install dependencies using uv:

   uv venv
   source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate
   uv pip install -r requirements.txt
   

3. Set up your Brave Search API key:

   export BRAVE_API_KEY=your_api_key_here
   

   On Windows, use: set BRAVE_API_KEY=your_api_key_here

Usage

1. Configure your MCP settings file (e.g., claude_desktop_config.json) to include the Brave Search MCP server:

   {
     "mcpServers": {
       "brave-search": {
         "command": "uv",
         "args": [
           "--directory",
           "path-to\\mcp-python\\brave-mcp-search\\src",
           "run",
           "server.py"
         ],
         "env": {
           "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY_HERE"
         }
       }
     }
   }
   

   Replace YOUR_BRAVE_API_KEY_HERE with your actual Brave API key.

2. Start the Brave Search MCP server by running your MCP-compatible AI assistant with the updated configuration.

3. The server will now be running and ready to accept requests from MCP clients.

4. You can now use the Brave Search functionality in your MCP-compatible AI assistant (like Claude) by invoking the available tools.

Available Tools

The server provides two main tools:

1. brave_web_search: Performs a web search using the Brave Search API.
2. brave_local_search: Searches for local businesses and places.

Refer to the tool docstrings in src/server.py for detailed usage information.

Development

To make changes to the project:

1. Modify the code in the src directory as needed.
2. Update the requirements.txt file if you add or remove dependencies:

   uv pip freeze > requirements.txt
   

3. Restart the server to apply changes.

Troubleshooting

If you encounter any issues:

1. Ensure your Brave API key is correctly set.
2. Check that all dependencies are installed.
3. Verify that you’re using a compatible Python version.
4. If you make changes to the code, make sure to restart the server.

License

This project is licensed under the MIT License - see the LICENSE file for details.