Brave Search MCP 서버

Brave Search API를 통합하여 웹 검색, 지역 관심 지점 검색, 비디오 검색, 이미지 검색 및 뉴스 검색 기능을 제공하는 MCP 서버 구현

특징

웹 검색 : 웹에서 정기적인 검색을 수행합니다.
이미지 검색 : 웹에서 이미지를 검색합니다. 이미지 검색 결과는 리소스로 제공됩니다.
뉴스 검색 : 웹에서 뉴스를 검색합니다
비디오 검색 : 웹에서 비디오를 검색합니다
지역 관심 지점 검색 : 지역 물리적 위치, 사업체, 레스토랑, 서비스 등을 검색하세요

도구

브레이브 웹 검색
- Brave의 API를 사용하여 웹 검색 실행
- 입력:
  - query (문자열): 인터넷에서 검색할 용어
  - count (숫자, 선택 사항): 반환할 결과 수(최대 20개, 기본값 10개)
용감한 이미지 검색
- 쿼리와 관련된 웹에서 이미지를 가져옵니다.
- 입력:
  - query (문자열): 인터넷에서 이미지를 검색하는 용어
  - count (숫자, 선택 사항): 반환할 이미지 수(최대 3개, 기본값 1개)
용감한 뉴스 검색
- 웹에서 뉴스를 검색합니다
- 입력:
  - query (문자열): 인터넷에서 뉴스 기사, 트렌드 주제 또는 최근 이벤트를 검색하는 용어
  - count (숫자, 선택 사항): 반환할 결과 수(최대 20개, 기본값 10개)
용감한 지역 검색
- 지역 기업, 서비스 및 관심 지점 검색
- 위치 결과를 보려면 Pro API 플랜 구독이 필요합니다.
- 위치 결과가 발견되지 않으면 brave_web_search로 돌아갑니다.
- 입력:
  - query (문자열): 로컬 검색어
  - count (숫자, 선택 사항): 반환할 결과 수(최대 20개, 기본값 5개)
용감한 비디오 검색
- 웹에서 비디오를 검색하세요
- 입력:
  - query : (문자열): 비디오를 검색할 용어
  - count : (숫자, 선택 사항): 반환할 비디오 수(최대 20개, 기본값 10개)

구성

API 키 받기

Brave Search API 계정 에 가입하세요
플랜 선택 (월 2,000개 쿼리가 가능한 무료 계층 제공)
개발자 대시보드에서 API 키를 생성하세요

Claude Desktop과 함께 사용

도커

저장소를 복제합니다
도커 빌드

지엑스피1

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

{
  "mcp-servers": {
    "brave-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRAVE_API_KEY",
        "brave-search-mcp"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR API KEY HERE"
      }
    }
  }
}

엔피엑스

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

{
  "mcp-servers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "brave-search-mcp"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR API KEY HERE"
      }
    }
  }
}

LibreChat과 함께 사용

librechat.yaml에 추가하세요

brave-search:
  command: sh
  args:
    - -c
    - BRAVE_API_KEY=API KEY npx -y brave-search-mcp

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

디버깅

저장소를 복제합니다
종속성을 설치하고 빌드합니다.

npm install

앱을 빌드하세요

npm run build

VS Code 실행 및 디버그 기능 사용

⚠ Windows 10/11에서는 작동하지 않는 듯하지만 WSL2에서는 작동합니다.

코드에서 완벽한 기능을 갖춘 중단점을 갖춘 VS Code 실행 및 디버그 런처를 사용하세요.

실행 디버그를 찾아 선택합니다.
드롭다운에서 " MCP Server Launcher "라고 표시된 구성을 선택합니다.
실행/디버그 버튼을 선택하세요. MCP Inspector 와 VS Code를 사용하여 다양한 도구를 디버깅할 수 있습니다.

VS 코드 디버그 설정

중단점을 사용하여 로컬 디버깅을 설정하려면:

VS 코드에 Brave API 키 저장
- 명령 팔레트를 엽니다(Cmd/Ctrl + Shift + P).
- 유형 Preferences: Open User Settings (JSON) .
- 다음 스니펫을 추가합니다.
{ "brave.search.api.key": "your-api-key-here" }
.vscode/launch.json 생성하거나 업데이트합니다.

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "MCP Server Launcher",
      "skipFiles": ["<node_internals>/**"],
      "program": "${workspaceFolder}/node_modules/@modelcontextprotocol/inspector/cli/build/cli.js",
      "outFiles": ["${workspaceFolder}/dist/**/*.js"],
      "env": {
        "BRAVE_API_KEY": "${config:brave.search.api.key}",
        "DEBUG": "true"
      },
      "args": ["dist/index.js"],
      "sourceMaps": true,
      "console": "integratedTerminal",
      "internalConsoleOptions": "neverOpen",
      "preLaunchTask": "npm: build:watch"
    },
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to Debug Hook Process",
      "port": 9332,
      "skipFiles": ["<node_internals>/**"],
      "sourceMaps": true,
      "outFiles": ["${workspaceFolder}/dist/**/*.js"]
    },
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to REPL Process",
      "port": 9333,
      "skipFiles": ["<node_internals>/**"],
      "sourceMaps": true,
      "outFiles": ["${workspaceFolder}/dist/**/*.js"]
    }
  ],
  "compounds": [
    {
      "name": "Attach to MCP Server",
      "configurations": ["Attach to Debug Hook Process", "Attach to REPL Process"]
    }
  ]
}

.vscode/tasks.json 생성합니다.

{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "npm",
      "script": "build:watch",
      "group": {
        "kind": "build",
        "isDefault": true
      },
      "problemMatcher": ["$tsc"]
    }
  ]
}

부인 성명

이 라이브러리는 Brave Software와 공식적으로 제휴 관계가 없습니다. MCP 서버를 사용하는 Brave Search API의 서드파티 구현입니다.

특허

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

Brave Search MCP

Integrations