Brave Search MCP 서버

이 프로젝트는 Brave Search를 위한 MCP(Model Context Protocol) 서버를 구현하여 Claude와 같은 AI 도우미와의 통합을 가능하게 합니다.

필수 조건

• 파이썬 3.11+
• uv - 빠른 Python 패키지 설치 및 확인 프로그램

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Brave Search MCP 서버를 자동으로 설치하려면:

지엑스피1

수동 설치

1. 저장소를 복제합니다.
   git clone https://github.com/your-username/brave-search-mcp.git cd brave-search-mcp
2. uv를 사용하여 가상 환경을 만들고 종속성을 설치합니다.
   uv venv source .venv/bin/activate # On Windows, use: .venv\Scripts\activate uv pip install -r requirements.txt
3. Brave Search API 키를 설정하세요:
   export BRAVE_API_KEY=your_api_key_here
   Windows에서는 다음을 사용하세요: set BRAVE_API_KEY=your_api_key_here

용법

1. MCP 설정 파일(예: claude_desktop_config.json )을 구성하여 Brave Search MCP 서버를 포함합니다.
   { "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" } } } }
   YOUR_BRAVE_API_KEY_HERE 실제 Brave API 키로 바꾸세요.
2. 업데이트된 구성으로 MCP 호환 AI 어시스턴트를 실행하여 Brave Search MCP 서버를 시작합니다.
3. 이제 서버가 실행되어 MCP 클라이언트의 요청을 수락할 준비가 되었습니다.
4. 이제 MCP 호환 AI 비서(예: Claude)에서 사용 가능한 도구를 호출하여 Brave Search 기능을 사용할 수 있습니다.

사용 가능한 도구

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

1. brave_web_search : Brave Search API를 사용하여 웹 검색을 수행합니다.
2. brave_local_search : 지역 업체와 장소를 검색합니다.

자세한 사용 정보는 src/server.py 에 있는 도구 docstring을 참조하세요.

개발

프로젝트를 변경하려면:

1. 필요에 따라 src 디렉토리의 코드를 수정합니다.
2. 종속성을 추가하거나 제거하는 경우 requirements.txt 파일을 업데이트하세요.
   uv pip freeze > requirements.txt
3. 변경 사항을 적용하려면 서버를 다시 시작하세요.

문제 해결

문제가 발생할 경우:

1. Brave API 키가 올바르게 설정되었는지 확인하세요.
2. 모든 종속성이 설치되었는지 확인하세요.
3. 호환되는 Python 버전을 사용하고 있는지 확인하세요.
4. 코드를 변경한 경우 서버를 다시 시작하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.