Brave Search MCP 서버
Brave Search API를 통합하여 웹 검색, 지역 관심 지점 검색, 비디오 검색, 이미지 검색 및 뉴스 검색 기능을 제공하는 MCP 서버 구현
특징
웹 검색 : 웹에서 정기적인 검색을 수행합니다.
이미지 검색 : 웹에서 이미지를 검색합니다. 이미지 검색 결과는 리소스로 제공됩니다.
뉴스 검색 : 웹에서 뉴스를 검색합니다
비디오 검색 : 웹에서 비디오를 검색합니다
지역 관심 지점 검색 : 지역 물리적 위치, 사업체, 레스토랑, 서비스 등을 검색하세요
Related MCP server: Brave Search MCP Server
도구
브레이브 웹 검색
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 buildVS 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 파일을 참조하세요.