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 엔드포인트

Related MCP server: WebSearch-MCP

필수 조건

• 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 엔드포인트

GET http://your-server:3001/sse

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

const eventSource = new EventSource('http://your-server:3001/sse');

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  // Handle the search results
  console.log(data);
};

eventSource.onerror = (error) => {
  console.error('SSE Error:', error);
  eventSource.close();
};

메시지 엔드포인트

POST http://your-server:3001/messages
Content-Type: application/json

{
  "query": "your search query",
  "count": 10  // optional, default: 10, max: 20
}

이 엔드포인트를 사용하면 연결된 모든 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 연결은 클라이언트가 닫을 때까지 열려 있습니다.

• 각 검색 결과는 연결된 모든 클라이언트에 브로드캐스트됩니다.

• 서버는 자동으로 연결 해제 및 정리를 처리합니다.

• 프로덕션 배포의 경우 메시지 엔드포인트에 대한 인증을 구현하는 것을 고려하세요.