shoofio/brave-search-mcp-sse

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

16 stars 12 forks Качество 68 Тренд 21MIT

Repository Install

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

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 Dockerfile for 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).

Открыть полный README на GitHub

Установка

docker run -d --rm \

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "brave-search": {
      "transport": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}