A
security-
licenseA
qualityA Model Context Protocol server that provides an image generation tool using Templated.io, allowing users to create customized images based on templates with text and image layers.
Last updated -
📦 プロジェクト概要
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"） | 任意 | デフォルト"AUTO" | |
rendering_speed | string | v3用レンダリング速度（"TURBO" | "DEFAULT" | "QUALITY"） | 任意 | ||
style_codes | string[] | 8文字のスタイルコード配列 | 任意 | ||||
style_type | string | スタイルタイプ（"AUTO" | "GENERAL" | "REALISTIC" | "DESIGN"） | 任意 | |
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
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that provides image generation capabilities using the Ideogram API, allowing users to create images from text prompts with customizable parameters.
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityA Model Context Protocol server that enables generation of high-quality images using the Flux.1 Schnell model via Together AI, allowing users to create images from text prompts with customizable dimensions.Last updated -115MIT License
- Asecurity-licenseAqualityA 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.Last updated -1144MIT License
- Asecurity-licenseAqualityA 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.Last updated -24516MIT License