Skip to main content
Glama
Sign In
deenesjakoruzh

Brave Search With Proxy

by kwp-lab
npmGitHub
JavaScript
MIT License
142
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Integrates with Brave Search API to provide web search capabilities with pagination and filtering, plus local business search with automatic fallback to web search when no results are found.

Brave Search MCP Server

An MCP server leveraging the Brave Search API for web and local search, with optional HTTP proxy configuration.

This repository forks from the Model Context Protocol servers and replaces the native fetch implementation with the library node-fetch-native.

The server will use the http_proxy and https_proxy environment variables to route requests through the proxy server by default if they are set. You also can set the BRAVE_SEARCH_PROXY environment variable to use a different proxy server.

Features

  • Web Search: General queries, news, articles, with pagination and freshness controls
  • Local Search: Find businesses, restaurants, and services with detailed information
  • Flexible Filtering: Control result types, safety levels, and content freshness
  • Smart Fallbacks: Local search automatically falls back to web when no results are found

Tools

  • brave_web_search
    • Execute web searches with pagination and filtering
    • Inputs:
      • query (string): Search terms
      • count (number, optional): Results per page (max 20)
      • offset (number, optional): Pagination offset (max 9)
  • brave_local_search
    • Search for local businesses and services
    • Inputs:
      • query (string): Local search terms
      • count (number, optional): Number of results (max 20)
    • Automatically falls back to web search if no local results found

Configuration

Getting an API Key

  1. Sign up for a Brave Search API account
  2. Choose a plan (Free tier available with 2,000 queries/month)
  3. Generate your API key from the developer dashboard

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

Docker

{ "mcpServers": { "brave-search": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "BRAVE_API_KEY", "mcp/brave-search" ], "env": { "BRAVE_API_KEY": "YOUR_API_KEY_HERE", "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed } } } }

NPX

{ "mcpServers": { "brave-search": { "command": "npx", "args": [ "-y", "@kwp-lab/mcp-brave-search" ], "env": { "BRAVE_API_KEY": "YOUR_API_KEY_HERE", "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed } } } }

Usage with VS Code

For quick installation, use the one-click installation buttons below...

For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open User Settings (JSON).

Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.

Note that the mcp key is not needed in the .vscode/mcp.json file.

Docker
{ "mcp": { "inputs": [ { "type": "promptString", "id": "brave_api_key", "description": "Brave Search API Key", "password": true } ], "servers": { "brave-search": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "BRAVE_API_KEY", "mcp/brave-search" ], "env": { "BRAVE_API_KEY": "${input:brave_api_key}", "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed } } } } }
NPX
{ "mcp": { "inputs": [ { "type": "promptString", "id": "brave_api_key", "description": "Brave Search API Key", "password": true } ], "servers": { "brave-search": { "command": "npx", "args": ["-y", "@kwp-lab/mcp-brave-search"], "env": { "BRAVE_API_KEY": "${input:brave_api_key}", "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed } } } } }

Build

Docker build:

docker build -t mcp/brave-search:latest -f ./Dockerfile .

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

An MCP server leveraging the Brave Search API for web and local search, with optional HTTP proxy configuration.

  1. Features
    1. Tools
      1. Configuration
        1. Getting an API Key
        2. Usage with Claude Desktop
        3. Docker
        4. NPX
        5. Usage with VS Code
      2. Build
        1. License

          Related MCP Servers

          • Brave Search MCP Server

            modelcontextprotocol
            -
            security
            A
            license
            -
            quality
            An MCP server implementation that integrates the Brave Search API, providing both web and local search capabilities.
            Last updated -
            2
            20,301
            45,638
            JavaScript
            MIT License
            • Linux
            • Apple

          • MCP2Brave

            mcp2everything
            -
            security
            A
            license
            -
            quality
            A server based on the MCP protocol that uses the Brave API for web search functionality.
            Last updated -
            6
            Python
            MIT License
            • Apple
            • Linux

          • Brave Search MCP Server

            arben-adm
            A
            security
            A
            license
            A
            quality
            Facilitates integration of Brave Search functionalities with AI assistants through the Model Context Protocol, enabling web and local searches using the Brave Search API.
            Last updated -
            2
            4
            Python
            MIT License

          View all related MCP servers

          New MCP Servers

          ID: kiwtu7vnxy