{"_id":"mcp-brave-search","_rev":"2-36e7ec37b12baea22ad9991713efd1e4","name":"mcp-brave-search","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"mcp-brave-search","version":"1.0.0","keywords":["mcp","brave","search","mcp-server","model-context-protocol","claude","ai","web-search","news-search"],"author":{"name":"yuandeshoulian"},"license":"MIT","_id":"mcp-brave-search@1.0.0","maintainers":[{"name":"yuandeshoulian","email":"yuandeshoulian@hotmail.com"}],"homepage":"https://github.com/yuandeshoulian/mcp-brave-search#readme","bugs":{"url":"https://github.com/yuandeshoulian/mcp-brave-search/issues"},"bin":{"mcp-brave-search":"build/index.js"},"dist":{"shasum":"38a902fd5b9580a9812be27d2dd3a5ffbe5dc9cb","tarball":"https://registry.npmjs.org/mcp-brave-search/-/mcp-brave-search-1.0.0.tgz","fileCount":35,"integrity":"sha512-PmbJuqprRvWLvRD/pHM2QBex0pjXr9Itof/H/xLwOe2qETV6D9/mWHEzmppg+jmyemIRfH1XQBrQ7xFSLxvn4Q==","signatures":[{"sig":"MEYCIQC2snU25cmxQmrDZdmX8U0323EwymSSTN/cWWQuBERqqQIhALLp2NInQ1kDoar5KCyidgfL+D0/5zYeN0az4Ti6aJnX","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":71966},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18"},"scripts":{"dev":"tsc --watch","test":"npm run test:api && npm run test:mcp","build":"tsc","start":"node build/index.js","prepare":"npm run build","test:api":"npm run build && node test/test-api.mjs","test:mcp":"npm run build && node test/test-mcp.mjs"},"_npmUser":{"name":"yuandeshoulian","email":"yuandeshoulian@hotmail.com"},"repository":{"url":"git+https://github.com/yuandeshoulian/mcp-brave-search.git","type":"git"},"_npmVersion":"10.8.2","description":"Brave Search MCP Server - Web and News Search via stdio","directories":{},"_nodeVersion":"20.18.3","dependencies":{"undici":"^7.16.0","https-proxy-agent":"^7.0.6","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-brave-search_1.0.0_1763456903435_0.8364996216691236","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"mcp-brave-search","version":"1.0.1","description":"Brave Search MCP Server - Web and News Search via stdio","type":"module","main":"./build/index.js","bin":{"mcp-brave-search":"build/index.js"},"scripts":{"build":"tsc","prepare":"npm run build","dev":"tsc --watch","start":"node build/index.js","test:api":"npm run build && node test/test-api.mjs","test:mcp":"npm run build && node test/test-mcp.mjs","test":"npm run test:api && npm run test:mcp"},"keywords":["mcp","brave","search","mcp-server","model-context-protocol","claude","ai","web-search","news-search"],"author":{"name":"yuandeshoulian"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/yuandeshoulian/mcp-brave-search.git"},"homepage":"https://github.com/yuandeshoulian/mcp-brave-search#readme","bugs":{"url":"https://github.com/yuandeshoulian/mcp-brave-search/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","https-proxy-agent":"^7.0.6","undici":"^7.16.0"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18"},"_id":"mcp-brave-search@1.0.1","types":"./build/index.d.ts","_nodeVersion":"20.18.3","_npmVersion":"10.8.2","dist":{"integrity":"sha512-9cAMxEsZfG7ipW2JGGzTNVYvLoRvvEq8Etq8kXp/iCIfP+vPiQS07eC5eJ5yV96sIxUnz4lfHlBFgOCk9Bk9Cw==","shasum":"0ac4b1c9c469fb6446ce4fdbf0b07377c8cb0e9c","tarball":"https://registry.npmjs.org/mcp-brave-search/-/mcp-brave-search-1.0.1.tgz","fileCount":35,"unpackedSize":72521,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC3lZh2ZQv5mKIuI6llif11Hd9q1py4w6nOc2LZeOKkXwIhAODOHZ4r2STDe8FZtHBxP5KjCtvan59yJpu+Isg8KUTM"}]},"_npmUser":{"name":"yuandeshoulian","email":"yuandeshoulian@hotmail.com"},"directories":{},"maintainers":[{"name":"yuandeshoulian","email":"yuandeshoulian@hotmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-brave-search_1.0.1_1763457156530_0.36559975662628097"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-18T09:08:23.320Z","modified":"2025-11-18T09:12:36.908Z","1.0.0":"2025-11-18T09:08:23.640Z","1.0.1":"2025-11-18T09:12:36.717Z"},"bugs":{"url":"https://github.com/yuandeshoulian/mcp-brave-search/issues"},"author":{"name":"yuandeshoulian"},"license":"MIT","homepage":"https://github.com/yuandeshoulian/mcp-brave-search#readme","keywords":["mcp","brave","search","mcp-server","model-context-protocol","claude","ai","web-search","news-search"],"repository":{"type":"git","url":"git+https://github.com/yuandeshoulian/mcp-brave-search.git"},"description":"Brave Search MCP Server - Web and News Search via stdio","maintainers":[{"name":"yuandeshoulian","email":"yuandeshoulian@hotmail.com"}],"readme":"# Brave Search MCP Server\n\nA Model Context Protocol (MCP) server that provides web and news search capabilities using the Brave Search API.\n\n## Features\n\n- **Web Search**: Search the web using Brave Search API with comprehensive filtering options\n- **News Search**: Search for recent news articles and breaking stories\n- **Stdio Transport**: Works seamlessly with Claude Desktop and other MCP clients\n- **TypeScript**: Fully typed for better developer experience\n- **Easy Deployment**: Simple npx-based deployment\n- **Proxy Support**: Built-in proxy support for users in China\n\n## Installation\n\n### Using npx (Recommended)\n\n```bash\nnpx mcp-brave-search\n```\n\n### Local Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Run locally\nnpm start\n```\n\n## Configuration\n\n### API Key Setup\n\n1. Get your Brave Search API key from [https://api.search.brave.com/](https://api.search.brave.com/)\n2. Set the environment variable:\n\n```bash\nexport BRAVE_API_KEY=\"your_api_key_here\"\n```\n\nOr create a `.env` file:\n\n```bash\ncp .env.example .env\n# Edit .env and add your API key\n```\n\n### Claude Desktop Configuration\n\nAdd to your Claude Desktop config file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"brave-search\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-brave-search\"],\n      \"env\": {\n        \"BRAVE_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Proxy Configuration (For Users in China / 代理配置)\n\nIf you're in China or behind a firewall, you need to configure a proxy to access the Brave Search API.\n\n如果你在中国大陆，需要配置代理才能访问 Brave Search API。\n\n```json\n{\n  \"mcpServers\": {\n    \"brave-search\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-brave-search\"],\n      \"env\": {\n        \"BRAVE_API_KEY\": \"your_api_key_here\",\n        \"HTTPS_PROXY\": \"http://127.0.0.1:7890\"\n      }\n    }\n  }\n}\n```\n\n**Supported proxy environment variables:**\n- `HTTPS_PROXY` or `https_proxy`\n- `HTTP_PROXY` or `http_proxy`\n\nCommon proxy ports:\n- Clash: `7890`\n- V2Ray: `10808`\n- Shadowsocks: `1080`\n\n**Note:** You don't need TUN mode if you configure the `HTTPS_PROXY` environment variable.\n\n## Available Tools\n\n### brave_web_search\n\nSearch the web using Brave Search API.\n\n**Parameters:**\n- `q` (required): Search query (max 400 chars, 50 words)\n- `count` (optional): Number of results (1-20, default: 10)\n- `offset` (optional): Pagination offset (0-9, default: 0)\n- `country` (optional): Country code (e.g., \"US\", \"GB\", \"CN\")\n- `search_lang` (optional): Search language (e.g., \"en\", \"zh\", \"es\")\n- `ui_lang` (optional): UI language (e.g., \"en-US\", \"zh-CN\")\n- `safesearch` (optional): Filter level - \"off\", \"moderate\", \"strict\"\n- `freshness` (optional): Time filter - \"pd\" (24h), \"pw\" (week), \"pm\" (month), \"py\" (year)\n- `text_decorations` (optional): Enable text decorations (boolean)\n- `spellcheck` (optional): Enable spellcheck (boolean)\n\n**Example:**\n```json\n{\n  \"q\": \"TypeScript best practices\",\n  \"count\": 5,\n  \"country\": \"US\",\n  \"search_lang\": \"en\"\n}\n```\n\n### brave_news_search\n\nSearch for news articles using Brave Search API.\n\n**Parameters:**\n- `q` (required): Search query (max 400 chars, 50 words)\n- `count` (optional): Number of results (1-20, default: 10)\n- `offset` (optional): Pagination offset (0-9, default: 0)\n- `country` (optional): Country code (e.g., \"US\", \"GB\", \"CN\")\n- `search_lang` (optional): Search language (e.g., \"en\", \"zh\", \"es\")\n- `ui_lang` (optional): UI language (e.g., \"en-US\", \"zh-CN\")\n- `safesearch` (optional): Filter level - \"off\", \"moderate\", \"strict\"\n- `freshness` (optional): Time filter - \"pd\" (24h), \"pw\" (week), \"pm\" (month), \"py\" (year)\n- `spellcheck` (optional): Enable spellcheck (boolean)\n\n**Example:**\n```json\n{\n  \"q\": \"AI technology news\",\n  \"count\": 10,\n  \"freshness\": \"pd\"\n}\n```\n\n## Future Enhancements\n\nThis server currently implements Web Search and News Search. Future versions may include:\n\n- Image Search\n- Video Search\n- Local/Places Search\n- Suggest API\n- HTTP transport mode (currently stdio only)\n- Additional search filters and options\n\n## API Documentation\n\nFor more details about the Brave Search API, visit:\nhttps://api-dashboard.search.brave.com/app/documentation/web-search/get-started\n\n## License\n\nMIT\n\n## Contributing\n\nContributions are welcome! Please feel free to submit issues or pull requests.\n","readmeFilename":"README.md"}