# 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