This MCP server provides image generation capabilities using the Replicate Flux model.
What is Image-Generation-MCP-Server
Image Generation MCP Server
This MCP server provides image generation capabilities using the Replicate Flux model.
Installation
Installing via Smithery
To install Image Generation MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @GongRzhe/Image-Generation-MCP-Server --client claude
Option 1: NPX Method (No Local Setup Required)
You can use the package directly from npm without installing it locally:
# No installation needed - npx will handle it
Option 2: Local Installation
If you prefer a local installation:
# Global installation
npm install -g @gongrzhe/image-gen-server
# Or local installation
npm install @gongrzhe/image-gen-server
Setup
Configure Claude Desktop
Edit your Claude Desktop configuration file:
- On MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- On Windows:
%APPDATA%/Claude/claude_desktop_config.json
Option 1: NPX Configuration (Recommended)
This method runs the server directly from npm without needing local files:
{
"mcpServers": {
"image-gen": {
"command": "npx",
"args": ["@gongrzhe/image-gen-server"],
"env": {
"REPLICATE_API_TOKEN": "your-replicate-api-token",
"MODEL": "alternative-model-name"
},
"disabled": false,
"autoApprove": []
}
}
}
Option 2: Local Installation Configuration
If you installed the package locally:
{
"mcpServers": {
"image-gen": {
"command": "node",
"args": ["/path/to/image-gen-server/build/index.js"],
"env": {
"REPLICATE_API_TOKEN": "your-replicate-api-token",
"MODEL": "alternative-model-name"
},
"disabled": false,
"autoApprove": []
}
}
}
Get Your Replicate API Token
- Sign up/login at https://replicate.com
- Go to https://replicate.com/account/api-tokens
- Create a new API token
- Copy the token and replace
your-replicate-api-token
in the MCP settings
Environment Variables
REPLICATE_API_TOKEN
(required): Your Replicate API token for authenticationMODEL
(optional): The Replicate model to use for image generation. Defaults to "black-forest-labs/flux-schnell"
Configuration Parameters
disabled
: Controls whether the server is enabled (false
) or disabled (true
)autoApprove
: Array of tool names that can be executed without user confirmation. Empty array means all tool calls require confirmation.
Available Tools
generate_image
Generates images using the Flux model based on text prompts.
Parameters
prompt
(required): Text description of the image to generateseed
(optional): Random seed for reproducible generationaspect_ratio
(optional): Image aspect ratio (default: "1:1")output_format
(optional): Output format - "webp", "jpg", or "png" (default: "webp")num_outputs
(optional): Number of images to generate (1-4, default: 1)
Example Usage
const result = await use_mcp_tool({
server_name: "image-gen",
tool_name: "generate_image",
arguments: {
prompt: "A beautiful sunset over mountains",
aspect_ratio: "16:9",
output_format: "png",
num_outputs: 1
}
});
The tool returns an array of URLs to the generated images.
📜 License
This project is licensed under the MIT License.
Leave a Comment
Frequently Asked Questions
What is MCP?
MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications, providing a standardized way to connect AI models to different data sources and tools.
What are MCP Servers?
MCP Servers are lightweight programs that expose specific capabilities through the standardized Model Context Protocol. They act as bridges between LLMs like Claude and various data sources or services, allowing secure access to files, databases, APIs, and other resources.
How do MCP Servers work?
MCP Servers follow a client-server architecture where a host application (like Claude Desktop) connects to multiple servers. Each server provides specific functionality through standardized endpoints and protocols, enabling Claude to access data and perform actions through the standardized protocol.
Are MCP Servers secure?
Yes, MCP Servers are designed with security in mind. They run locally with explicit configuration and permissions, require user approval for actions, and include built-in security features to prevent unauthorized access and ensure data privacy.
Related MCP Servers
Ableton Live MCP Server
MCP Server implementation for Ableton Live OSC control
Airbnb MCP Server
AI Agent Marketplace Index Search MCP Server
MCP Server for AI Agent Marketplace Index from DeepNLP
Algorand MCP Implementation
Algorand Model Context Protocol (Server & Client)
mcp-server-apache-airflow
pypi.org/project/mcp-server-apache-airflow/
airtable-mcp-server
🗂️🤖 Airtable Model Context Protocol Server, for allowing AI systems to interact with your Airtable bases
Airtable MCP Server
Search, create and update Airtable bases, tables, fields, and records using Claude Desktop and MCP (Model Context Protocol) clients
Alphavantage MCP Server
A MCP server for the stock market data API, Alphavantage API.
Amadeus MCP Server
Amadeus MCP(Model Context Protocol) Server
Anki MCP Server
An MCP server for Anki
Submit Your MCP Server
Share your MCP server with the community
Submit Now