Ideogram MCP Server

📦 プロジェクト概要
Ideogram API (v3.0) をMCPサーバー経由で使えるTypeScript製ツール
画像生成・スタイル参照・マジックプロンプト・アスペクト比・モデル選択など多機能
Claude Desktopや他MCPクライアントから即利用OK
Related MCP server: OpenAI MCP
⚡️ クイックスタート
Claude Desktopや他MCPクライアントで爆速連携したいなら、
下記JSONスニペットを設定ファイルにコピペでOK!✨
{
"mcpServers": {
"ideogram": {
"command": "npx",
"args": [
"@sunwood-ai-labs/ideagram-mcp-server"
],
"env": {
"IDEOGRAM_API_KEY": "your_api_key_here"
}
}
}
}🛠️ MCPツール仕様
generate_image
パラメータ一覧(最新版)
パラメータ | 型 | 説明 | 必須/任意 | 備考 |
prompt | string | 画像生成プロンプト(英語推奨) | 必須 | |
aspect_ratio | string | アスペクト比(例: "1x1", "16x9", "4x3" など) | 任意 | 15種類 |
resolution | string | 解像度(公式ドキュメント参照、全69種) | 任意 | |
seed | integer | 乱数シード(再現性担保用) | 任意 | 0~2147483647 |
magic_prompt | string | マジックプロンプト("AUTO" | "ON" | "OFF") |
rendering_speed | string | v3用レンダリング速度("TURBO" | "DEFAULT" | "QUALITY") |
style_codes | string[] | 8文字のスタイルコード配列 | 任意 | |
style_type | string | スタイルタイプ("AUTO" | "GENERAL" | "REALISTIC" |
negative_prompt | string | 除外要素(英語推奨) | 任意 | |
num_images | number | 生成画像数(1~8) | 任意 | |
style_reference | object | スタイル参照(Ideogram 3.0新機能) | 任意 | 下記詳細 |
└ urls | string[] | 参照画像URL配列(最大3つ) | 任意 | |
└ style_code | string | スタイルコード | 任意 | |
└ random_style | boolean | ランダムスタイル使用 | 任意 | |
output_dir | string | 画像保存ディレクトリ(デフォルト: "docs") | 任意 | |
base_filename | string | 保存ファイル名のベース(デフォルト: "ideogram-image") | 任意 | タイムスタンプ・ID付与 |
blur_mask | boolean | 画像の縁をぼかす(trueでマスク合成) | 任意 | デフォルト: false |
📝 使用例
const result = await use_mcp_tool({
server_name: "ideagram-mcp-server",
tool_name: "generate_image",
arguments: {
prompt: "A beautiful sunset over mountains",
aspect_ratio: "16x9",
rendering_speed: "QUALITY",
num_images: 2,
style_reference: {
urls: [
"https://example.com/ref1.jpg",
"https://example.com/ref2.jpg"
],
random_style: false
},
blur_mask: true
}
});🧑💻 開発・ビルド・テスト
npm run build... TypeScriptビルドnpm run watch... 開発モード(自動ビルド)npm run lint... コードリントnpm test... テスト実行
🗂️ ディレクトリ構成
ideagram-mcp-server/
├── assets/
├── docs/
│ └── ideogram-image_2025-05-18T06-31-45-777Z.png
├── src/
│ ├── tools/
│ ├── types/
│ ├── utils/
│ ├── ideogram-client.ts
│ ├── index.ts
│ ├── server.ts
│ └── test.ts
├── .env.example
├── package.json
├── tsconfig.json
├── README.md
└── ...(省略)📝 コントリビューション
このリポジトリをフォーク
新ブランチ作成 (
git checkout -b feature/awesome)変更コミット(コミットメッセージは日本語+絵文字推奨!)
プッシュ&プルリク作成
🚀 デプロイ & リリース
GitHub Actionsで自動npm公開
バージョン更新→タグpushで自動デプロイ
npm version patch|minor|major
git push --follow-tags詳細は docs/npm-deploy.md を参照!
📄 ライセンス
MIT
Available Tools
1 toolgenerate_imageC
Generate an image using Ideogram AI
Inputs: prompt (required), aspect_ratio, resolution, seed, +11 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools. The single tool 'generate_image' has a clearly distinct and unambiguous purpose.
A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The name 'generate_image' follows a clear verb_noun pattern.
One tool is too few for a server named 'Ideogram MCP Server', which suggests a broader scope for image generation or AI tasks. A single tool feels thin and limited for such a domain.
The tool surface is severely incomplete for an image generation server. It only offers generation with no options for editing, listing, deleting, or managing images, creating significant gaps in functionality.
Maintenance
Related MCP Connectors
MCP server for Qwen Image 3 AI image generation
Generate images from Claude, ChatGPT, Cursor and Codex with 12 top AI image models. Up to 4 images per call, SVG vectorization, background removal, upscaling and image-to-video. Remote MCP with OAuth, no API keys.
Generate AI images and videos from any compatible MCP client.
MCP server for Flux AI image generation
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA server that provides AI-powered image generation, modification, and processing capabilities through the Model Context Protocol, leveraging Google Gemini models and other image services.19MIT
- AlicenseNot gradedqualityFmaintenanceA Model Context Protocol server enabling AI assistants to generate images through OpenAI's DALL-E API with full support for all available options and fine-grained control.1MIT
- AlicenseDqualityDmaintenanceA Model Context Protocol server that provides image generation capabilities using Google's Gemini 2 API, allowing users to generate multiple images with customizable parameters like prompts, aspect ratios, and person generation settings.16MIT
- AlicenseDqualityDmaintenanceA Model Context Protocol server that enables generating and editing images using OpenAI's gpt-image-1 model, allowing AI assistants to create and modify images from text prompts.218MIT