Brave Search API를 통합하는 MCP 서버 구현은 웹 및 로컬 검색 기능을 모두 제공합니다.

특징

• **웹 검색 **: 일반 쿼리, 뉴스, 기사, 질 및 신선도 제어
• Local Search: 기업, 레스토랑, 서비스 찾기
• Flexible Filtering: 제어 결과 유형, 안전 수준, 콘텐츠 신선도
• Smart Fallbacks: 로컬 검색은 자동으로 웹으로 돌아갑니다. 결과가 없습니다.

도구

• **brave web search **

• pagination 및 필터링으로 웹 검색 수행

• 입력:

• query (string): 검색 조건

• count (숫자, 선택): 페이지 당 결과 (최대 20)

• offset (number, 선택 사항) : Pagination offset (최대 9)

• **brave local search **

• 현지 기업 및 서비스 검색

• 입력:

• query (string): 현지 검색 조건

• count (number, 옵션) : 결과 수 (최대 20)

• 자동으로 발견되지 않은 경우 웹 검색으로 돌아갑니다.

구성

API 키 얻기

1. Brave Search API 계정 가입
2. 플랜을 선택 (무료 계층 2,000 쿼리 / 월 사용 가능)
3. 개발자 대시보드에서 API 키 생성

Brave Search MCP Server

An MCP server implementation that integrates the Brave Search API, providing both web and local search capabilities.

Features

• Web Search: General queries, news, articles, with pagination and freshness controls
• Local Search: Find businesses, restaurants, and services with detailed information
• Flexible Filtering: Control result types, safety levels, and content freshness
• Smart Fallbacks: Local search automatically falls back to web when no results are found

Tools

• brave_web_search

  • Execute web searches with pagination and filtering
  • Inputs:
    • query (string): Search terms
    • count (number, optional): Results per page (max 20)
    • offset (number, optional): Pagination offset (max 9)

• brave_local_search

  • Search for local businesses and services
  • Inputs:
    • query (string): Local search terms
    • count (number, optional): Number of results (max 20)
  • Automatically falls back to web search if no local results found

Configuration

Getting an API Key

1. Sign up for a Brave Search API account
2. Choose a plan (Free tier available with 2,000 queries/month)
3. Generate your API key from the developer dashboard

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "brave-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRAVE_API_KEY",
        "mcp/brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Usage with VS Code

For quick installation, use the one-click installation buttons below…