Brave Image

An MCP (Model Context Protocol) server for Brave Image Search API. Search images directly from AI assistants like Claude.

Author: Ilker Tosun License: MIT

---

Features

• search_images — Search images with full filter support (country, language, safesearch, spellcheck)
• search_images_batch — Run multiple image searches in a single call (up to 10 queries)
• Returns image URLs, thumbnails, dimensions, source pages, and confidence scores
• Proper error handling for rate limits, invalid keys, and bad parameters

---

Requirements

• Node.js >= 18
• A Brave Search API key → Get one here

---

Installation

git clone https://github.com/ilker-tosun/brave-image-mcp.git
cd brave-image-mcp
npm install
npm run build

---

Configuration

Set your API key as an environment variable:

export BRAVE_API_KEY=your_api_key_here

Or add it to your MCP client config (see below).

---

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "brave-image-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/brave-image-mcp/dist/index.js"],
      "env": {
        "BRAVE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Usage with n8n (MCP Client Node)

1. Build the project (npm run build)
2. In n8n, add an MCP Client node
3. Set transport to stdio
4. Command: node /absolute/path/to/brave-image-mcp/dist/index.js
5. Add environment variable: BRAVE_API_KEY=your_api_key_here

---

Tools

search_images

Search images for a single query.

Parameter	Type	Required	Description
query	string	✅	Search query (max 400 chars, 50 words)
count	number	❌	Results to return (1–200, default: 20)
country	string	❌	2-letter country code or ALL
search_lang	string	❌	Language code (e.g. en, tr)
safesearch	off | strict	❌	Content filter level
spellcheck	boolean	❌	Enable spell checking (default: true)

search_images_batch

Search images for multiple queries at once.

Parameter	Type	Required	Description
queries	string[]	✅	Array of queries (max 10)
count	number	❌	Results per query (1–200, default: 10)
country	string	❌	2-letter country code or ALL
search_lang	string	❌	Language code
safesearch	off | strict	❌	Content filter level
spellcheck	boolean	❌	Enable spell checking

---

Rate Limits

Plan	Limit
Free	1 req/sec
Pro	20 req/sec

---

License

MIT © Ilker Tosun