Brave Search MCP Server

SSE 지원이 포함된 Brave Search MCP

이는 Brave Search 기능과 SSE(Server-Sent Events) 통합 기능을 제공하는 MCP(Model Context Protocol) 서버입니다. Coolify에 배포하여 실시간 검색 서비스로 사용할 수 있습니다.

특징

• MCP를 통한 Brave Search API 통합
• SSE를 사용한 실시간 검색 결과
• Docker와 Coolify 준비 완료
• TypeScript 구현
• Express.js SSE 엔드포인트

필수 조건

• Brave Search API 키
• 노드.js 18+
• Docker(컨테이너화된 배포용)
• Coolify 인스턴스

지역 개발

1. 저장소를 복제합니다
2. Brave API 키로 .env 파일을 만듭니다.지엑스피1
3. 종속성 설치:
   npm install
4. 개발 서버 시작:
   npm run dev

도커 배포

1. docker-compose를 사용하여 빌드하고 실행합니다.
   docker-compose up --build

쿨파이 배포

1. Coolify 대시보드에서 새 서비스를 만듭니다.
2. "소스에서 배포"를 선택하세요
3. 다음을 구성하세요.
   • 저장소 URL: 저장소 URL
   • 지점: 본점
   • 빌드 명령: npm run build
   • 시작 명령: npm start
   • 포트: 3001
   • 환경 변수:
     • BRAVE_API_KEY=여기에 API 키를 입력하세요
     • 포트=3001

SSE 통합 사용

SSE 엔드포인트

SSE 엔드포인트는 실시간 검색 결과를 제공합니다. EventSource API를 사용하여 연결하세요.

메시지 엔드포인트

이 엔드포인트를 사용하면 연결된 모든 SSE 클라이언트에 브로드캐스트되는 검색을 트리거할 수 있습니다.

MCP 사용

서버는 다음과 같은 MCP 도구를 제공합니다.

• brave_web_search : Brave Search API를 사용하여 웹 검색을 수행합니다.
  { query: string; // Search query count?: number; // Number of results (1-20, default: 10) }

오류 처리

• 서버는 연결된 모든 SSE 클라이언트에 오류를 브로드캐스트합니다.
• 오류는 다음과 같은 형식으로 표시됩니다.
  { "type": "error", "error": "error message" }

노트

• SSE 연결은 클라이언트가 닫을 때까지 열려 있습니다.
• 각 검색 결과는 연결된 모든 클라이언트에 브로드캐스트됩니다.
• 서버는 자동으로 연결 해제 및 정리를 처리합니다.
• 프로덕션 배포의 경우 메시지 엔드포인트에 대한 인증을 구현하는 것을 고려하세요.