Ideagram Mcp Server
What is Ideagram Mcp Server
Ideagram MCP Server is a server that provides image generation capabilities using the Ideogram API, designed to facilitate the creation of images based on user-defined prompts.
Use cases
Use cases for the Ideagram MCP Server include generating artistic images for creative projects, creating visuals for marketing materials, and producing images for social media content based on specific themes or prompts.
How to use
To use the Ideagram MCP Server, install the necessary dependencies with ‘npm install’, set up the environment variables in a .env file, build the project with ‘npm run build’, and optionally link it globally with ‘npm link’. You can generate images by calling the ‘generate_image’ tool with required and optional parameters.
Key features
Key features include prompt-based image generation, customizable parameters such as aspect ratio, model selection, magic prompt options, style types, negative prompts, and the number of images to generate.
Where to use
undefined
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Ideagram Mcp Server
Ideagram MCP Server is a server that provides image generation capabilities using the Ideogram API, designed to facilitate the creation of images based on user-defined prompts.
Use cases
Use cases for the Ideagram MCP Server include generating artistic images for creative projects, creating visuals for marketing materials, and producing images for social media content based on specific themes or prompts.
How to use
To use the Ideagram MCP Server, install the necessary dependencies with ‘npm install’, set up the environment variables in a .env file, build the project with ‘npm run build’, and optionally link it globally with ‘npm link’. You can generate images by calling the ‘generate_image’ tool with required and optional parameters.
Key features
Key features include prompt-based image generation, customizable parameters such as aspect ratio, model selection, magic prompt options, style types, negative prompts, and the number of images to generate.
Where to use
undefined
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
🎨 Ideogram MCP Server
Ideogram APIを使って画像生成を提供するModel Context Protocol (MCP) サーバーだよ！
Ideogram 3.0対応で、Claude DesktopやMCPクライアントから爆速連携できるのが神✨
📦 プロジェクト概要
- Ideogram API (v3.0) をMCPサーバー経由で使えるTypeScript製ツール
- 画像生成・スタイル参照・マジックプロンプト・アスペクト比・モデル選択など多機能
- Claude Desktopや他MCPクライアントから即利用OK
⚡️ クイックスタート
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
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
