Brave Search API를 통합한 MCP 서버 구현체로, 웹 검색, 지역 비즈니스 검색, 장소 검색, 이미지 검색, 동영상 검색, 뉴스 검색, LLM 컨텍스트, AI 기반 요약 등 포괄적인 검색 기능을 제공합니다. 이 프로젝트는 STDIO와 HTTP 전송 모두를 지원하며, STDIO를 기본 모드로 사용합니다.

이주

1.x에서 2.x로

기본 전송 지금 STDIO

기존 MCP 관례를 따르기 위해 서버는 이제 기본 STDIO가 됩니다. HTTP를 계속 사용하고 싶다면 BRAVE_MCP_TRANSPORT 환경 변수를 http로 설정하거나, 서버를 실행할 때 런타임 인수 --transport http를 제공해야 합니다.

[[T3]의 응답 구조

MCP 서버 버전 1.x는 base64로 인코딩된 이미지 데이터와 이미지 URL을 반환했습니다. 이로 인해 응답 속도가 크게 느려졌고, 세션 내 불필요한 맥락 소모도 발생했습니다. 버전 2.x는 base64로 인코딩된 데이터를 제거하고, 원래 Brave Search API 응답을 더 잘 반영하는 응답 객체를 반환합니다. 업데이트된 출력 스키마는 src/tools/images/schemas/output.ts에 정의되어 있습니다.

도구

웹 검색 (brave_web_search)

Brave Search MCP Server

An MCP server implementation that integrates the Brave Search API, providing comprehensive search capabilities including web search, local business search, place search, image search, video search, news search, LLM context, and AI-powered summarization. This project supports both STDIO and HTTP transports, with STDIO as the default mode.

Migration

1.x to 2.x

Default transport now STDIO

To follow established MCP conventions, the server now defaults to STDIO. If you would like to continue using HTTP, you will need to set the BRAVE_MCP_TRANSPORT environment variable to http, or provide the runtime argument --transport http when launching the server.

Response structure of brave_image_search

Version 1.x of the MCP server would return base64-encoded image data along with image URLs. This dramatically slowed down the response, as well as consumed unnecessarily context in the session. Version 2.x removes the base64-encoded data, and returns a response object that more closely reflects the original Brave Search API response. The updated output schema is defined in src/tools/images/schemas/output.ts.

Tools

Web Search (brave_web_search)

Performs comprehensive web searches with rich result types and advanced filtering options.

Parameters:

• query (string, required): Search terms (max 400 chars, 50 words)
• country (string, optional): Country code (default: “US”)
• search_lang (string, optional): Search language (default: “en”)
• ui_lang (string, optional): UI language (default: “en-US”)
• count (number, optional): Results per page (1-20, default: 10)
• offset (number, optional): Pagination offset (max 9, default: 0)
• safesearch (string, optional): Content filtering (“off”, “moderate”, “strict”, default: “moderate”)
• freshness (string, optional): Time filter (“pd”, “pw”, “pm”, “py”, or date range)
• text_decorations (boolean, optional): Include highlighting markers (default: true)
• spellcheck (boolean, optional): Enable spell checking (default: true)
• result_filter (array, optional): Filter result types (default: [“web”, “query”])
• goggles (array, optional): Custom re-ranking definitions
• units (string, optional): Measurement units (“metric” or “imperial”)
• extra_snippets (boolean, optional): Get additional excerpts (Pro plans only)
• summary (boolean, optional): Enable summary key generation for AI summarization

Local Search (brave_local_search)

Searches for local businesses and places with detailed information including ratings, hours, and AI-generated descriptions.

Parameters:

• Same as brave_web_search with automatic location filtering
• Automatically includes “web” and “locations” in result_filter