Content
# Agnes Image MCP Server
MCP server for **Agnes Image 2.1 Flash** (text-to-image generation), connected via OpenAI-compatible API.
## Features
- Generate images from text prompts
- Supports aspect ratios (1:1, 16:9, 9:16, 4:3, 3:4, etc.)
- Custom resolution (1K~4K)
- Multi-image generation
- Returns clickable image URLs
## Requirements
- Node.js >= 18
- A [platform.agnes-ai.com](https://platform.agnes-ai.com) API key
## Install
```bash
cd agnes-image-mcp-server
npm install
npm start
```
## Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
| `AGNES_API_KEY` | ✅ | — | Your Agnes AI API key |
| `AGNES_MODEL` | | `agnes-image-2.1-flash` | Model name |
| `AGNES_BASE_URL` | | `https://apihub.agnes-ai.com/v1` | API base URL |
## CC-Switch / Claude Code Config
```json
{
"mcpServers": {
"agnes-image": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@kira4094/agnes-image-mcp-server"],
"env": {
"AGNES_API_KEY": "your-agnes-api-key"
}
}
}
}
```
## Tool: `agnes_image_generate`
| Parameter | Type | Required | Description |
|---|---|---|---|
| `prompt` | string | ✅ | Text description (Chinese/English) |
| `size` | string | | Resolution (`1024x1024`, `1024x768`, `768x1024`) |
| `ratio` | string | | Aspect ratio (`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, etc.) |
| `n` | number | | Number of images (default 1) |
## License
MIT
