Skip to main content
Glama
deenesjakoruzh
kwp-lab

Brave Search With Proxy

by kwp-lab
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
JavaScript
Remote

Brave Search MCP 서버

웹 및 로컬 검색을 위한 Brave Search API를 활용하는 MCP 서버이며, 선택적 HTTP 프록시 구성이 가능합니다.

이 저장소는 Model Context Protocol 서버 에서 포크되어 기본 fetch 구현을 라이브러리 node-fetch-native 로 대체합니다.

서버는 기본적으로 http_proxy 및 https_proxy 환경 변수를 사용하여 프록시 서버를 통해 요청을 라우팅합니다(설정된 경우). BRAVE_SEARCH_PROXY 환경 변수를 설정하여 다른 프록시 서버를 사용할 수도 있습니다.

특징

  • 웹 검색 : 일반 쿼리, 뉴스, 기사, 페이지 매김 및 신선도 제어 기능 포함

  • 지역 검색 : 자세한 정보와 함께 업체, 레스토랑 및 서비스를 찾아보세요

  • 유연한 필터링 : 결과 유형, 안전 수준 및 콘텐츠 신선도 제어

  • 스마트 폴백 : 로컬 검색은 결과가 발견되지 않으면 자동으로 웹으로 돌아갑니다.

Related MCP server: MCP2Brave

도구

  • 브레이브 웹 검색

    • 페이지 매김 및 필터링을 사용하여 웹 검색 실행

    • 입력:

      • query (문자열): 검색어

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

      • offset (숫자, 선택 사항): 페이지 번호 오프셋(최대 9)

  • 용감한 지역 검색

    • 지역 기업 및 서비스 검색

    • 입력:

      • query (문자열): 로컬 검색어

      • count (숫자, 선택 사항): 결과 수(최대 20개)

    • 로컬 검색 결과가 없으면 자동으로 웹 검색으로 돌아갑니다.

구성

API 키 받기

  1. Brave Search API 계정 에 가입하세요

  2. 플랜 선택 (월 2,000개 쿼리가 가능한 무료 계층 제공)

  3. 개발자 대시보드에서 API 키 생성

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요:

도커

지엑스피1

엔피엑스

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@kwp-lab/mcp-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE",
        "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed
      }
    }
  }
}

VS Code를 사용한 사용

빠른 설치를 위해 아래의 원클릭 설치 버튼을 사용하세요...

VS Code에서 NPX로 설치 VS Code Insiders에서 NPX로 설치

VS Code에서 Docker로 설치 VS Code Insiders에서 Docker로 설치

수동 설치의 경우, VS Code의 사용자 설정(JSON) 파일에 다음 JSON 블록을 추가하세요. Ctrl + Shift + P 를 누르고 Preferences: Open User Settings (JSON) 입력하면 됩니다.

원하는 경우, 작업 공간의 .vscode/mcp.json 파일에 추가할 수 있습니다. 이렇게 하면 다른 사용자와 구성을 공유할 수 있습니다.

.vscode/mcp.json 파일에는 mcp 키가 필요하지 않습니다.

도커

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "brave_api_key",
        "description": "Brave Search API Key",
        "password": true
      }
    ],
    "servers": {
      "brave-search": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "BRAVE_API_KEY",
          "mcp/brave-search"
        ],
        "env": {
          "BRAVE_API_KEY": "${input:brave_api_key}",
          "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed
        }
      }
    }
  }
}

엔피엑스

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "brave_api_key",
        "description": "Brave Search API Key",
        "password": true
      }
    ],
    "servers": {
      "brave-search": {
        "command": "npx",
        "args": ["-y", "@kwp-lab/mcp-brave-search"],
        "env": {
          "BRAVE_API_KEY": "${input:brave_api_key}",
          "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed
        }
      }
    }
  }
}

짓다

Docker 빌드:

docker build -t mcp/brave-search:latest -f ./Dockerfile .

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

Available Tools

2 tools

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updates
    • First observedbrave_local_search
    • First observedbrave_web_search
Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

A4.3/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: brave_local_search targets local businesses and physical locations with 'near me' queries, while brave_web_search handles general web searches for information, news, and online content. There is no overlap in functionality, as each tool is specialized for different query types and data sources, making it easy for an agent to choose the correct one based on the user's intent.

Naming Consistency5/5

Both tool names follow a consistent pattern: 'brave_' prefix followed by a descriptive term ('local_search' and 'web_search') using snake_case. This naming convention clearly indicates the server domain (Brave Search) and the specific search type, making the tools predictable and easy to understand without any deviations or mixed styles.

Tool Count3/5

With only 2 tools, the server feels thin for a search domain, as it might benefit from additional tools like image search, news search, or advanced filtering options. However, the tools cover the core local and web search functionalities adequately, so it's borderline but not severely lacking. A typical search server would have more tools to handle diverse query types and result formats.

Completeness4/5

The server covers the essential search operations for local and web queries, with each tool providing detailed capabilities like pagination, filtering, and fallback mechanisms. Minor gaps exist, such as no dedicated tools for image or video searches, but agents can work around this using the web search tool. The surface is reasonably complete for basic search needs without significant dead ends.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Brave Search MCP Server

    Shoofio
    A
    license
    Not graded
    quality
    F
    maintenance
    An MCP server that integrates the Brave Search API to provide both web and local search capabilities, with features like pagination, filtering, and smart fallbacks.
    15
    MIT

  • Brave Search MCP

    mikechao
    A
    license
    A
    quality
    D
    maintenance
    An MCP Server implementation that integrates the Brave Search API, providing, Web Search, Local Points of Interest Search, Image Search, Video Search, News Search and LLM Context Search capabilities
    5
    196
    125
    GPL 3.0