Catalog npm
Back to packageRELEASE DETAILS

1.0.3

npm

4oimage-mcp

MCP server for 4o-image API integration - Generate images using text prompts and edit existing images

3d-character-creator4o-imageaction-figureaiai-barbie-generatorchgpt-dog-to-humanclaudeimageimage-generationmcpmodelcontextprotocoltext-to-image
Published22 Apr 2025
Direct dependencies7
Transitive dependenciesNot calculated

README

Current package documentation

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.

npm version Node.js Version License: MIT

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.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 7

Native requirements
7 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
zod
Environment
{
  "local_name": "zod",
  "alias": false,
  "peer_metadata": null
}
^3.22.4runtime
open
Environment
{
  "local_name": "open",
  "alias": false,
  "peer_metadata": null
}
^10.1.1runtime
express
Environment
{
  "local_name": "express",
  "alias": false,
  "peer_metadata": null
}
^4.18.2runtime
form-data
Environment
{
  "local_name": "form-data",
  "alias": false,
  "peer_metadata": null
}
^4.0.0runtime
node-fetch
Environment
{
  "local_name": "node-fetch",
  "alias": false,
  "peer_metadata": null
}
^3.3.2runtime
@modelcontextprotocol/sdk
Environment
{
  "local_name": "@modelcontextprotocol/sdk",
  "alias": false,
  "peer_metadata": null
}
^1.10.1runtime
nodemon
Environment
{
  "local_name": "nodemon",
  "alias": false,
  "peer_metadata": null
}
^3.0.1development

Distribution files

1 collected
Distribution 1

Source distribution

Source file
Checksums from source
{
  "shasum": "ff5f24940fc3e5bd5d779672323223f4264112f8",
  "tarball": "https://registry.npmjs.org/4oimage-mcp/-/4oimage-mcp-1.0.3.tgz",
  "fileCount": 6,
  "integrity": "sha512-B3k7liZM8WPupn1gZDvqAQ9wOQpCl3qZwaxyoJSN9Rt8cgXFJTQepBD6UzUcmwTyNbKaJ6heWNoXAT21ErS44A==",
  "signatures": [
    {
      "sig": "MEUCIQC4cBBjVT0B8E7UJiEHDRugcJZnuh7vJisRAofbObg1KgIgO2Ewx6TbH1L2dhA4+4+L4rxbMkzFn7/2tDJl+uDUdHs=",
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
    }
  ],
  "unpackedSize": 21928
}

Repository

PENDING
yourusername/4oimage-mcp

Shared repository data · GitHub

License detected in repository
Not collected

Repository

PENDING
antipas/4oimage-mcp

Shared repository data · GitHub

License detected in repository
Not collected

Repository

PENDING
yourusername/4o-image-mcp

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 20:14 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:81c96843aa67f002c131d9ecb136be32fbc06013aa52224c2ad167fb0e9fd1f7

Other collected versions

1.0.522 Apr1.0.422 Apr1.0.222 Apr1.0.122 Apr1.0.022 AprView all collected versions →