Image Generator MCP Server

A Laravel app that exposes AI image generation as a Model Context Protocol (MCP) tool, built with laravel/mcp and laravel/ai. Any MCP-compatible client — Claude, Claude Code, Cursor, ChatGPT, etc. — can call it to generate an image from a text prompt.

What it does

The server registers one tool, generate-image. When an MCP client calls it with a prompt, the tool passes the prompt to the Laravel AI SDK, which generates the image via OpenAI, Gemini, or xAI (whichever provider you've configured), stores the result, and returns the image (or a link to it) back to the client.

Requirements

• PHP 8.2+, Laravel 12.x or 13.x
• An API key for at least one supported image provider

Installation

composer require laravel/mcp laravel/ai

php artisan vendor:publish --tag=ai-routes
php artisan vendor:publish --provider="Laravel\Ai\AiServiceProvider"
php artisan migrate

Add a provider key to .env:

OPENAI_API_KEY=
GEMINI_API_KEY=
XAI_API_KEY=

The server is registered in routes/ai.php:

use App\Mcp\Servers\ImageGeneratorServer;
use Laravel\Mcp\Facades\Mcp;

Mcp::web('/mcp/image-generator', ImageGeneratorServer::class);

How to use it

Point any MCP client at the server's URL:

{
  "mcpServers": {
    "image-generator": {
      "url": "https://your-app.test/mcp/image-generator"
    }
  }
}

Once connected, just ask the client to generate an image — for example, "generate an image of a private jet" — and it will call the generate-image tool with your prompt and return the result. The tool accepts:

• prompt (required) — what to generate
• aspect_ratio — square, portrait, or landscape (default square)
• quality — low, medium, or high (default medium)

If the endpoint requires authentication, add a bearer token to the client config:

{
  "mcpServers": {
    "image-generator": {
      "url": "https://your-app.test/mcp/image-generator",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}