{"id":28169365,"url":"https://github.com/kwp-lab/mcp-brave-search","last_synced_at":"2026-03-04T05:01:50.382Z","repository":{"id":292200397,"uuid":"979967482","full_name":"kwp-lab/mcp-brave-search","owner":"kwp-lab","description":"An MCP server for integrating with the Brave Search API, and it supports HTTP proxying.","archived":false,"fork":false,"pushed_at":"2025-05-11T16:40:04.000Z","size":33,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-02T09:58:56.006Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kwp-lab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-08T10:57:41.000Z","updated_at":"2025-10-04T14:57:17.000Z","dependencies_parsed_at":"2025-05-08T17:38:34.342Z","dependency_job_id":null,"html_url":"https://github.com/kwp-lab/mcp-brave-search","commit_stats":null,"previous_names":["kwp-lab/mcp-brave-search"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kwp-lab/mcp-brave-search","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kwp-lab%2Fmcp-brave-search","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kwp-lab%2Fmcp-brave-search/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kwp-lab%2Fmcp-brave-search/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kwp-lab%2Fmcp-brave-search/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kwp-lab","download_url":"https://codeload.github.com/kwp-lab/mcp-brave-search/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kwp-lab%2Fmcp-brave-search/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30071895,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T03:25:38.285Z","status":"ssl_error","status_checked_at":"2026-03-04T03:25:05.086Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-15T16:16:47.393Z","updated_at":"2026-03-04T05:01:50.339Z","avatar_url":"https://github.com/kwp-lab.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Brave Search MCP Server\n\nAn MCP server leveraging the Brave Search API for web and local search, with optional HTTP proxy configuration.\n\n\u003ca href=\"https://glama.ai/mcp/servers/@kwp-lab/mcp-brave-search\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@kwp-lab/mcp-brave-search/badge\" /\u003e\n\u003c/a\u003e\n\nThis repository forks from the [Model Context Protocol servers](https://github.com/modelcontextprotocol/servers) and replaces the native `fetch` implementation with the library [node-fetch-native](https://www.npmjs.com/package/node-fetch-native).\n\nThe server will use the `http_proxy` and `https_proxy` environment variables to route requests through the proxy server by default if they are set.\nYou also can set the `BRAVE_SEARCH_PROXY` environment variable to use a different proxy server.\n\n## Features\n\n- **Web Search**: General queries, news, articles, with pagination and freshness controls\n- **Local Search**: Find businesses, restaurants, and services with detailed information\n- **Flexible Filtering**: Control result types, safety levels, and content freshness\n- **Smart Fallbacks**: Local search automatically falls back to web when no results are found\n\n## Tools\n\n- **brave_web_search**\n\n  - Execute web searches with pagination and filtering\n  - Inputs:\n    - `query` (string): Search terms\n    - `count` (number, optional): Results per page (max 20)\n    - `offset` (number, optional): Pagination offset (max 9)\n\n- **brave_local_search**\n  - Search for local businesses and services\n  - Inputs:\n    - `query` (string): Local search terms\n    - `count` (number, optional): Number of results (max 20)\n  - Automatically falls back to web search if no local results found\n\n## Configuration\n\n### Getting an API Key\n\n1. Sign up for a [Brave Search API account](https://brave.com/search/api/)\n2. Choose a plan (Free tier available with 2,000 queries/month)\n3. Generate your API key [from the developer dashboard](https://api-dashboard.search.brave.com/app/keys)\n\n### Usage with Claude Desktop\n\nAdd this to your `claude_desktop_config.json`:\n\n### Docker\n\n```json\n{\n  \"mcpServers\": {\n    \"brave-search\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-e\",\n        \"BRAVE_API_KEY\",\n        \"mcp/brave-search\"\n      ],\n      \"env\": {\n        \"BRAVE_API_KEY\": \"YOUR_API_KEY_HERE\",\n        \"BRAVE_SEARCH_PROXY\": \"https://example.com:10890\" // Optional, remove if not needed\n      }\n    }\n  }\n}\n```\n\n### NPX\n\n```json\n{\n  \"mcpServers\": {\n    \"brave-search\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@kwp-lab/mcp-brave-search\"\n      ],\n      \"env\": {\n        \"BRAVE_API_KEY\": \"YOUR_API_KEY_HERE\",\n        \"BRAVE_SEARCH_PROXY\": \"https://example.com:10890\" // Optional, remove if not needed\n      }\n    }\n  }\n}\n```\n\n### Usage with VS Code\n\nFor quick installation, use the one-click installation buttons below...\n\n[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-NPM-0098FF?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=brave\u0026inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%7D%5D\u0026config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-brave-search%22%5D%2C%22env%22%3A%7B%22BRAVE_API_KEY%22%3A%22%24%7Binput%3Abrave_api_key%7D%22%7D%7D) [![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-NPM-24bfa5?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=brave\u0026inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%7D%5D\u0026config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-brave-search%22%5D%2C%22env%22%3A%7B%22BRAVE_API_KEY%22%3A%22%24%7Binput%3Abrave_api_key%7D%22%7D%7D\u0026quality=insiders)\n\n[![Install with Docker in VS Code](https://img.shields.io/badge/VS_Code-Docker-0098FF?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=brave\u0026inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%7D%5D\u0026config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22BRAVE_API_KEY%22%2C%22mcp%2Fbrave-search%22%5D%2C%22env%22%3A%7B%22BRAVE_API_KEY%22%3A%22%24%7Binput%3Abrave_api_key%7D%22%7D%7D) [![Install with Docker in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Docker-24bfa5?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=brave\u0026inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%7D%5D\u0026config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22BRAVE_API_KEY%22%2C%22mcp%2Fbrave-search%22%5D%2C%22env%22%3A%7B%22BRAVE_API_KEY%22%3A%22%24%7Binput%3Abrave_api_key%7D%22%7D%7D\u0026quality=insiders)\n\nFor 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)`.\n\nOptionally, you can add it to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others.\n\n\u003e Note that the `mcp` key is not needed in the `.vscode/mcp.json` file.\n\n#### Docker\n\n```json\n{\n  \"mcp\": {\n    \"inputs\": [\n      {\n        \"type\": \"promptString\",\n        \"id\": \"brave_api_key\",\n        \"description\": \"Brave Search API Key\",\n        \"password\": true\n      }\n    ],\n    \"servers\": {\n      \"brave-search\": {\n        \"command\": \"docker\",\n        \"args\": [\n          \"run\",\n          \"-i\",\n          \"--rm\",\n          \"-e\",\n          \"BRAVE_API_KEY\",\n          \"mcp/brave-search\"\n        ],\n        \"env\": {\n          \"BRAVE_API_KEY\": \"${input:brave_api_key}\",\n          \"BRAVE_SEARCH_PROXY\": \"https://example.com:10890\" // Optional, remove if not needed\n        }\n      }\n    }\n  }\n}\n```\n\n#### NPX\n\n```json\n{\n  \"mcp\": {\n    \"inputs\": [\n      {\n        \"type\": \"promptString\",\n        \"id\": \"brave_api_key\",\n        \"description\": \"Brave Search API Key\",\n        \"password\": true\n      }\n    ],\n    \"servers\": {\n      \"brave-search\": {\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"@kwp-lab/mcp-brave-search\"],\n        \"env\": {\n          \"BRAVE_API_KEY\": \"${input:brave_api_key}\",\n          \"BRAVE_SEARCH_PROXY\": \"https://example.com:10890\" // Optional, remove if not needed\n        }\n      }\n    }\n  }\n}\n```\n\n## Build\n\nDocker build:\n\n```bash\ndocker build -t mcp/brave-search:latest -f ./Dockerfile .\n```\n\n## License\n\nThis 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkwp-lab%2Fmcp-brave-search","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkwp-lab%2Fmcp-brave-search","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkwp-lab%2Fmcp-brave-search/lists"}