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: Bing Search MCP Server

필수 조건

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

지역 개발

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

도커 배포

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

쿨파이 배포

Coolify 대시보드에서 새 서비스를 만듭니다.
"소스에서 배포"를 선택하세요
다음을 구성하세요.
- 저장소 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 연결은 클라이언트가 닫을 때까지 열려 있습니다.
각 검색 결과는 연결된 모든 클라이언트에 브로드캐스트됩니다.
서버는 자동으로 연결 해제 및 정리를 처리합니다.
프로덕션 배포의 경우 메시지 엔드포인트에 대한 인증을 구현하는 것을 고려하세요.

Brave Search MCP Server