article

README

🎨 Ideogram MCP Server

GitHub GitHub package.json version GitHub issues GitHub pull requests npm npm

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"） | 任意 | デフォルト"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

ideagram-mcp-server