https://github.com/GongRzhe/Image-Generation-MCP-Server
This MCP server provides image generation capabilities using the Replicate Flux model.
https://github.com/GongRzhe/Image-Generation-MCP-Server
Last synced: about 1 month ago
JSON representation
This MCP server provides image generation capabilities using the Replicate Flux model.
- Host: GitHub
- URL: https://github.com/GongRzhe/Image-Generation-MCP-Server
- Owner: GongRzhe
- License: mit
- Created: 2025-02-23T10:47:53.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-03-25T07:03:51.000Z (about 2 months ago)
- Last Synced: 2025-03-25T08:20:28.330Z (about 2 months ago)
- Language: JavaScript
- Homepage:
- Size: 16.6 KB
- Stars: 8
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-zh - Image Generation
- awesome-mcp-servers - Image Generation - This MCP server provides image generation capabilities using the Replicate Flux model. (Table of Contents / AI Services)
- awesome-mcp-servers - Image Generation - This MCP server provides image generation capabilities using the Replicate Flux model. (Table of Contents / AI Services)
README
# Image Generation MCP Server
This MCP server provides image generation capabilities using the Replicate Flux model.
## Installation
### Option 1: NPX Method (No Local Setup Required)
You can use the package directly from npm without installing it locally:
```bash
# No installation needed - npx will handle it
```
### Option 2: Local Installation
If you prefer a local installation:
```bash
# 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:
```json
{
"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:
```json
{
"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
1. Sign up/login at https://replicate.com
2. Go to https://replicate.com/account/api-tokens
3. Create a new API token
4. Copy the token and replace `your-replicate-api-token` in the MCP settings
### Environment Variables
- `REPLICATE_API_TOKEN` (required): Your Replicate API token for authentication
- `MODEL` (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 generate
- `seed` (optional): Random seed for reproducible generation
- `aspect_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
```typescript
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.