/ 디렉터리 / 플레이그라운드 / Brave Search
● 공식 brave 🔑 본인 키 필요

Brave Search

제작: brave · modelcontextprotocol/servers

개인정보를 존중하는 웹, 뉴스, 이미지 검색 — 독립적 인덱스, Google 없음. 무료 등급으로 대부분의 개인 사용 커버.

Brave Search MCP의 참조 구현입니다. Brave Search API를 래핑하며, 웹, 로컬, 뉴스, 비디오, 이미지 검색을 제공합니다. Brave는 독립적 인덱스를 운영하고 있으며(Bing/Google 리셀러가 아님), 개인정보 보호를 보장하고 적절한 수준의 무료 할당량을 제공합니다.

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

brave-search.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "brave-search",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "brave-search": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-brave-search"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add brave-search -- npx -y @modelcontextprotocol/server-brave-search

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Brave Search

여러 독립적 출처로 주장 사실 확인하기

👤 작가, 연구자, AI 환각을 우려하는 모든 사람 ⏱ ~5 min beginner

언제 쓸까: 주장('X 회사가 Y명의 직원을 보유'등)이 있고 Claude가 학습 데이터에서 기억하는 것이 아닌 2-3개의 인용문을 원할 때 사용하세요.

사전 조건
  • Brave Search API 키 — api.search.brave.com — 무료 등급 월 2천회, 카드 불필요
흐름
  1. 주장 검색
    Brave에서 'Acme Robotics employee count site:linkedin.com OR site:crunchbase.com' 검색. 상위 5개 결과.✓ 복사됨
    → 여러 독립적 출처의 혼합
  2. 숫자 조정
    각 출처마다 약간씩 다른 숫자를 제시할 것 같습니다. 날짜와 함께 나열하세요. 인용 가능한 가장 신뢰할 수 있는 숫자는 무엇입니까?✓ 복사됨
    → 출처별 숫자 + 근거 있는 선택
  3. 인용문 형식 지정
    인라인 인용과 함께 주장을 작성하세요. 가장 최신의 가장 권위 있는 출처를 사용하세요.✓ 복사됨
    → 문장 + (출처, 날짜) 인라인

결과: 근거 있는 인용과 함께 작업이 표시된 주장.

함정
  • 단일 SERP 스니펫으로는 충분하지 않음 — 주장이 잘못 인용될 수 있음 — 중요한 주장의 경우, 실제 페이지를 가져오고(fetch MCP) 맥락 내에서 인용문을 확인하세요
함께 쓰기: fetch

특정 주제의 오늘 뉴스 가져오기

👤 최신 뉴스 요약을 원하는 모든 사람 ⏱ ~5 min beginner

언제 쓸까: Claude의 학습 데이터보다 최신인 틈새 주제의 뉴스 요약을 원할 때 사용하세요.

흐름
  1. 뉴스 검색
    Brave 뉴스 검색: 지난 7일간 'EU AI Act enforcement', 상위 10개.✓ 복사됨
    → 날짜가 있는 최근 뉴스 항목
  2. 그룹화 + 요약
    각도별로 그룹화하세요. 각 그룹을 1문장으로 요약하세요. 출처 간에 충돌하는 주장을 표시하세요.✓ 복사됨
    → 2-4개의 주제별 그룹(충돌 플래그 포함)
  3. 중요한 항목 선택
    이 중 하나만 5분 안에 읽을 수 있다면 어느 것이 왜 좋을까요?✓ 복사됨
    → 이유가 있는 단일 추천

결과: 시간을 존중하는 최신 이벤트 요약.

함정
  • 같은 뉴스 기사가 20개 사이트에 재게시됨 = 잘못된 합의감 — Claude가 URL뿐 아니라 리드문 유사성으로 중복을 감지하도록 하세요

실제 작업을 위해 지역 비즈니스 찾기

👤 여행이나 지역 심부름을 계획하는 모든 사람 ⏱ ~5 min beginner

언제 쓸까: 지도를 열지 않고도 '여기 근처 최고의 라면'같은 답을 원할 때 사용하세요.

흐름
  1. 로컬 검색
    Brave 로컬 검색으로 'Mission District, San Francisco' 근처 'ramen' 검색. 주소, 평점(있으면)과 함께 상위 10개.✓ 복사됨
    → 주소가 있는 실제 사업체
  2. 취향에 따라 필터링
    손으로 뽑은 국수를 원하고, 체인 레스토랑은 원하지 않습니다. 이 중 어느 것이 맞습니까?✓ 복사됨
    → 근거가 있는 필터링된 목록
  3. 최적의 선택 고르기
    하나를 선택하세요. 주소, 알려진 영업시간, 그리고 그것이 올바른 선택인 이유를 알려주세요.✓ 복사됨
    → 결정적인 추천

결과: 행동할 수 있는 선택, Yelp를 스크롤할 필요 없음.

함정
  • 로컬 데이터 신선도가 다양함 — 폐업한 사업체가 여전히 나타날 수 있음 — 높은 이해관계(30분 운전)가 있는 경우, 사업체의 자체 사이트를 통해 영업시간을 확인하세요
함께 쓰기: google-maps

조합

다른 MCP와 조합해 10배 효율

brave-search + fetch

검색 → 가장 관련 있는 URL 가져오기 → 요약

Brave에서 'OWASP LLM top 10 2026' 검색. 상위 결과의 전체 콘텐츠를 가져오고 10개 항목을 요약하세요.✓ 복사됨
brave-search + memory

검색으로 파생된 사실을 나중에 회수하기 위해 관찰로 저장

상위 5개 경쟁사의 인원수를 검색하세요. 각각을 메모리의 해당 회사 엔티티에 대한 관찰로 저장하세요.✓ 복사됨
brave-search + google-maps

Brave가 후보 찾기 → Google Maps가 길 안내

Brave 로컬을 통해 Mission의 라면집 찾기. 상위 3개에 대해 Mission/16th BART에서 Google Maps를 통해 도보 길 안내 받기.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
brave_web_search query: str, count?: int (1-20), offset?: int 일반 웹 검색 할당량에 대한 1회 검색
brave_local_search query: str, count?: int 지역 근처 사업체, POI 찾기 1회 검색

비용 및 제한

운영 비용

API 쿼터
무료 등급: 월 2,000회 검색, 초당 1회 검색. 유료 플랜도 있습니다.
호출당 토큰
개수에 따라 응답당 약 500-2000개 토큰
금액
개인 사용은 무료, 더 높은 할당량은 유료 플랜
기본적으로 count: 5를 사용하세요. 상위 5개가 보통 필요한 모든 신호입니다 — 20개 결과에 비용을 지불하는 것은 거의 가치가 없습니다.

보안

권한, 시크릿, 파급범위

자격 증명 저장: 환경 변수 BRAVE_API_KEY의 API 키
데이터 외부 송신: 쿼리는 api.search.brave.com으로 전송되며, Brave의 개인정보 보호 정책이 적용됩니다

문제 해결

자주 발생하는 오류와 해결

401 Unauthorized

MCP 클라이언트 환경에서 BRAVE_API_KEY를 설정하세요. api.search.brave.com에서 키를 받으세요.

429 Too Many Requests

무료 등급은 초당 1회 검색입니다. 배치 워크플로우에서 검색 사이에 제한을 추가하세요.

Quota exceeded

월간 한도에 도달했습니다. 재설정을 기다리거나 업그레이드하세요.

Local search returns empty

로컬 인덱스는 주요 도시 외의 지역에서 적용 범위가 제한됩니다. 틈새 위치의 경우 웹 검색으로 대체하세요.

대안

Brave Search 다른 것과 비교

대안언제 쓰나단점/장점
Exa Search MCP신경망/시맨틱 검색과 전체 페이지 콘텐츠를 원할 때다른 모델, '나처럼 X 같은 것을 찾아'에 더 적합
Google's official Programmable Search (custom MCP)Google 특화 신호가 필요할 때설정 복잡성; 대량 사용 시 더 비싼 비용
DuckDuckGo via fetch무료 검색을 원할 때구조화된 API 없음, HTML 파싱 필요

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기