What is 4oimage Mcp

4oimage-mcp is an MCP server implementation that integrates with the 4o-image API, allowing large language models (LLMs) and other AI systems to generate and edit images through a standardized protocol. It enables users to create high-quality art, 3D characters, and custom images using simple text prompts.

Use cases

Use cases for 4oimage-mcp include generating images for storytelling, creating custom graphics for video games, designing marketing materials, and transforming existing images based on user-defined prompts.

How to use

To use 4oimage-mcp, you need to register for an account at 4o-image.app to obtain an API key. Then, set the API key as an environment variable when running the server. You can integrate it with applications like Claude by adding specific configurations in the JSON format.

Key features

Key features of 4oimage-mcp include text-to-image generation, image editing capabilities, real-time progress updates on generation status, and automatic opening of generated images in the default browser.

Where to use

4oimage-mcp can be used in various fields such as digital art creation, game development, marketing, and any application that requires image generation or editing based on textual descriptions.

4o-image MCP Server

An MCP server implementation that integrates with 4o-image API, enabling LLMs and other AI systems to generate and edit images through a standardized protocol. Create high-quality art, 3D characters, and custom images using simple text prompts.

Features

• Text-to-Image Generation: Create images from text descriptions with AI
• Image Editing: Transform existing images using text prompts
• Real-time Progress Updates: Get feedback on generation status
• Browser Integration: Automatically open generated images in your default browser

Tools

• generateImage
  • Generate images based on text prompts with optional image editing
  • Inputs:
    • prompt (string, required): Text description of the desired image
    • imageBase64 (string, optional): Base64-encoded image for editing or style transfer

Configuration

Getting an API Key

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

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

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

Example Usage

Here’s an example of using this MCP server with Claude:

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

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

For image editing, you can include a base image and prompt Claude to modify it:

Edit this image to make the sky more dramatic with storm clouds

License

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