brave-search-mcp은(는) 무엇을 하나요?
Brave Search MCP v2.x - 36개 도구에서 7개로 간소화됨. 독립 검색 인덱스, Google 래퍼 없음
이 MCP 서버는 Brave Search API와 인터페이스하는 Model Context Protocol 서버를 제공합니다. LLM(대규모 언어 모델, 예: Claude, Cursor, Codex 등)이 검색을 할 수 있도록 지원합니다.
도구
-
brave_web_search
- 설명: 웹 검색 수행
- 입력:
query(문자열, 필수): 검색할 검색어count(정수, 선택 사항, 기본값=10, 최대=50): 반환할 결과 수offset(정수, 선택 사항, 기본값=0): 검색 결과 오프셋(페이지 매김에 유용)
- 출력: 검색 결과 목록(각 결과에는 제목, URL, 설명, 출처가 있음)
-
brave_web_search_stream (권장됨)
- 설명: 브라우저 스트리밍 형식으로 웹 검색 수행
- 입력: 위와 동일
- 출력: 각 검색 결과를 개별 SSE 이벤트로 스트리밍
-
brave_local_search
- 설명: 지역 비즈니스 및 장소 검색
- 입력:
query(문자열, 필수): 검색어count(정수, 선택 사항, 기본값=5, 최대=25): 반환할 결과 수
- 출력: 세부 정보(주소, 평점, 전화번호, 영업 시간 등)가 포함된 지역 결과
-
brave_local_search_stream (권장됨)
- 설명: 스트리밍 형식으로 지역 검색 수행
- 입력: 위와 동일
- 출력: 각 결과를 개별 SSE 이벤트로 스트리밍
-
brave_news_search
- 설명: 뉴스 기사 검색
- 입력:
query(문자열, 필수): 검색어count(정수, 선택 사항, 기본값=10, 최대=50): 반환할 결과 수freshness(선택 사항): 시간 필터(예:pd= 지난 24시간,pw= 지난 주,pm= 지난 달)offset(정수, 선택 사항, 기본값=0): 검색 결과 오프셋
- 출력: 발행일, 출처, 요약이 포함된 뉴스 기사 목록
-
brave_news_search_stream (권장됨)
- 설명: 스트리밍 형식으로 뉴스 검색 수행
- 입력: 위와 동일
- 출력: 각 기사를 개별 SSE 이벤트로 스트리밍
-
brave_image_search
- 설명: 이미지 검색 수행
- 입력:
query(문자열, 필수): 검색할 용어count(정수, 선택 사항, 기본값=10, 최대=50): 반환할 결과 수offset(정수, 선택 사항, 기본값=0): 검색 결과 오프셋
- 출력: 썸네일 URL, 원본 URL, 설명이 포함된 이미지 목록
설정
API 키 받기
- Brave Search API로 이동하세요.
- 가입하고 API 키를 받으세요(무료 등급으로 초당 최대 1회 요청, 2,000회/월 무료).
- API 키를 안전하게 보관하세요.
Claude Desktop에서 사용
claude_desktop_config.json에 다음을 추가하세요:
npx
{
"mcpServers": {
"brave-search": {
"command": "npx",
"args": [
"-y",
"@anthropic-ai/mcp-server-brave-search"
],
"env": {
"BRAVE_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}
라이선스
이 MCP 서버는 MIT 라이선스에 따라 제공됩니다. 이 저장소 내의 코드를 수정하고 배포할 수 있습니다.
문제 해결
API 키가 BRAVE_API_KEY 환경 변수에 올바르게 설정되어 있고 키가 활성 상태인지 확인하세요. 무료 등급은 2,000회/월로 제한됩니다. 로컬 네트워크나 방화벽이 Brave Search API(api.search.brave.com)에 대한 아웃바운드 연결을 차단하지 않는지 확인하세요.
지원
문제가 발생하면 GitHub Issues를 통해 보고해 주세요.