shoofio/brave-search-mcp-sse
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
Stream Brave Search (web & local) results via a Model Context Protocol (MCP) / Server-Sent Events (SSE) interface.
개요
An implementation of the Model Context Protocol (MCP) using Server-Sent Events (SSE) that integrates the Brave Search API, providing AI models and other clients with web and local search capabilities through a streaming interface. This server acts as a tool provider for Large Language Models that understand the Model Context Protocol. It exposes Brave's powerful web and local search functionalities via an SSE connection, allowing for real-time streaming of search results and status updates. * Designed with centrality in mind, allowing organizations or individuals to manage a single Brave Search API key and provide controlled access to multiple internal clients or applications. * Features robust logging to track requests, API interactions, errors, and rate limits, providing visibility into usage and aiding debugging. * Can be deployed privately within a network or optionally exposed publicly via methods like Kubernetes Ingress or direct Docker port mapping.
README
원문 README의 일부입니다. 원문 보기.
Brave Search MCP/SSE Server
An implementation of the Model Context Protocol (MCP) using Server-Sent Events (SSE) that integrates the Brave Search API, providing AI models and other clients with web and local search capabilities through a streaming interface.
Overview
This server acts as a tool provider for Large Language Models that understand the Model Context Protocol. It exposes Brave’s powerful web and local search functionalities via an SSE connection, allowing for real-time streaming of search results and status updates.
Key Design Goals:
- Centralized Access: Designed with centrality in mind, allowing organizations or individuals to manage a single Brave Search API key and provide controlled access to multiple internal clients or applications.
- Observability: Features robust logging to track requests, API interactions, errors, and rate limits, providing visibility into usage and aiding debugging.
- Flexible Deployment: Can be deployed privately within a network or optionally exposed publicly via methods like Kubernetes Ingress or direct Docker port mapping.
Features
- Web Search: Access Brave’s independent web search index for general queries, news, articles, etc. Supports pagination and filtering controls.
- Local Search: Find businesses, restaurants, and services with detailed information like address, phone number, and ratings.
- Smart Fallbacks: Local search automatically falls back to a filtered web search if no specific local results are found for the query.
- Server-Sent Events (SSE): Efficient, real-time streaming of search results and tool execution status.
- Model Context Protocol (MCP): Adheres to the MCP standard for seamless integration with compatible clients.
- Docker Support: Includes a
Dockerfilefor easy containerization and deployment. - Helm Chart: Provides a Helm chart for straightforward deployment to Kubernetes clusters.
Prerequisites
Depending on your chosen deployment method, you will need some of the following:
- Brave Search API Key: Required for all deployment methods. See “Getting Started” below.
- Docker: Required if deploying using Docker.
- kubectl & Helm: Required if deploying to Kubernetes using Helm.
- Node.js & npm: Required only for local development (Node.js v22.x or later recommended).
설치
docker run -d --rm \설정
{
"mcpServers": {
"brave-search": {
"transport": "sse",
"url": "http://localhost:8080/sse"
}
}
}