Agnes Image MCP Server

0 starsCommunity

Install to Claude Code

This server doesn't publish a one-line install command. Follow the setup in the source repository.

Summary

Enables text-to-image generation using Agnes Image 2.1 Flash via OpenAI-compatible API, supporting aspect ratios, custom resolution, and multi-image generation.

README.md

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 API key

Install

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

{
  "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) |