https://github.com/antipas/4oimage-mcp
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.
https://github.com/antipas/4oimage-mcp
Last synced: 5 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/antipas/4oimage-mcp
- Owner: Antipas
- License: mit
- Created: 2025-04-22T07:04:03.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-04-26T14:28:05.000Z (7 months ago)
- Last Synced: 2025-06-17T13:20:02.019Z (5 months ago)
- Language: JavaScript
- Size: 16.6 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- toolsdk-mcp-registry - ✅ 4oimage-mcp - image API for generating and editing high-quality images through text prompts with real-time progress updates. (1 tools) (node) (Art & Culture / How to Submit)
README
# 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.
[](https://www.npmjs.com/package/4oimage-mcp)
[](https://nodejs.org)
[](https://opensource.org/licenses/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](https://4o-image.app/dashboard/)
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`:
```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.