MODEL CONTEXT PROTOCOL · AI TOOLING

imagehub-mcp

Empowers AI agents (Claude, Gemini, Antigravity) to search, filter, download, and organize millions of royalty-free images seamlessly.

Protocol
MCP 1.0 (SDK)
Tools
27 Actionable Tools
API Provider
Pixabay REST API
Runtime
Node.js / TypeScript

Executive TL;DR — Engineering Brief

imageHub-MCP is an authorial Model Context Protocol server developed by Alex Santos. It equips autonomous AI coding agents with 27 granular tools to discover, download, resize, and bookmark royalty-free visuals without leaving their conversational workflow.

DIAGRAM & WORKFLOW

Tool Registry & Request Execution Flow

How AI agents invoke imageHub-MCP tools through stdio / JSON-RPC to query and stream media assets.

DETAILED ENGINEERING

Core Technical Pillars

Design choices, architectural patterns, and engineering decisions implemented for extreme reliability and developer experience.

01

Comprehensive 27-Tool Catalog

From semantic queries to batch downloads and moodboard curation

Includes tools for keyword search, color filtering, orientation filters, category queries, multi-size asset downloads, favorites management, and markdown preview generation.

02

Strict JSON-RPC & MCP Schema Validation

Deterministic parameter definitions backed by Zod schemas

Every tool parameter is strictly validated using Zod, ensuring AI agents receive descriptive errors and self-correct their tool invocation payloads automatically.

03

Rate Limiting & Efficient Media Caching

Protecting upstream quotas with intelligent local asset resolution

Implements client-side query caching and verifies file existence before executing disk downloads, conserving bandwidth and keeping agent latency minimal.

04

Zero-Friction Agent Integration

Ready for Claude Desktop, Cursor, and custom agentic frameworks

Configurable via a simple JSON snippet in claude_desktop_config.json or antigravity MCP config, communicating over high-speed stdio streams.

CODE IN ACTION

MCP Configuration & Invocation Example

Real-world usage, terminal configuration, and technical integration commands.

Terminal Example SHELL
{
  "mcpServers": {
    "imagehub": {
      "command": "npx",
      "args": ["-y", "imagehub-mcp"],
      "env": {
        "PIXABAY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
QUESTIONS & ANSWERS

Technical Frequently Asked Questions

Key clarifications regarding licensing, compatibility, deployment, and security.

Do I need a Pixabay API key?

Yes. Pixabay provides free API keys with generous hourly allowances for personal and commercial usage.

Can AI agents download images directly to the project directory?

Yes. Tools like download_image allow agents to save assets directly into targeted project directories.

What types of media are supported?

Photos, vector illustrations, and transparent PNG illustrations.

Is imageHub-MCP open source?

Yes, licensed under the permissive MIT license.