4oimage MCP

🚀 4o-image MCP Server

An MCP server implementation integrating the 4o-image API, enabling large language models (LLMs) and other AI systems to generate and edit images through a standardized protocol. Create high-quality artworks, 3D characters, and custom images using simple text prompts.

🚀 Quick Start

This 4o-image MCP Server integrates with the 4o-image API, allowing LLMs and other AI systems to generate and edit images via a standardized protocol. Users can create high - quality images with simple text prompts.

✨ Features

• Text-to-Image Generation: Generate images based on text descriptions.
• Image Editing: Transform existing images using text prompts.
• Real-time Progress Updates: Get feedback on the generation status.
• Browser Integration: Automatically open the generated images in the default browser.

📚 Documentation

Tools

• generateImage
  • Generate an image based on a text prompt, with an optional image editing feature.
  • Input:
    • prompt (string, required): A textual description of the desired image.
    • imageBase64 (string, optional): Base64 encoding of the base image for editing or style transformation.

Configuration

Obtain an API Key

1. Register an account at 4o-image.app.
2. Retrieve the API key from the user dashboard.
3. Provide the API key as an environment variable when running the server.

Use Claude Desktop

Add the following content to claude_desktop_config.json:

{
  "mcpServers": {
    "4o-image": {
      "command": "npx",
      "args": [
        "-y",
        "4oimage-mcp"
      ],
      "env": {
        "API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

💻 Usage Examples

Basic Usage

Here is an example of using this MCP server with Claude:

Generate an image of a dog running on a beach at sunset.

Claude will use the MCP server to generate the image, which will automatically open in the default browser. You will also get a direct link to the image in Claude's response.

Advanced Usage

For image editing, you can include a base image and prompt Claude to make modifications:

Change the sky in this image to more dramatic storm clouds.

📄 License

This MCP server is released under the MIT License. You are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.