ideagram mcp server

Local 2025-09-01 00:08:06 0

Image And Video Processing @Sunwood-ai-labs/ideagram-mcp-server

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.

# ? Ideogram MCP Server

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

Ideogram APIを使用して画像生成機能を提供するModel Context Protocol (MCP) サーバー

https://github.com/user-attachments/assets/041553d3-6fbc-4dfa-b149-d195dcb9e8f8

? 機能

プロンプトに基づく画像生成
カスタマイズ可能なパラメータ
アスペクト比
モデル選択
マジックプロンプト
スタイルタイプ
ネガティブプロンプト
生成画像数

? セットアップ

必要な依存関係をインストール:
```
npm install
```
環境変数の設定: .envファイルを作成し、以下の内容を追加:
```
IDEOGRAM_API_KEY=your_api_key_here
```
ビルド:
```
npm run build
```
（オプション）グローバルにインストール:
```
npm link
```

? 使用方法

MCPツール

generate_image

画像を生成するためのツール。

必須パラメータ: - prompt: 画像生成に使用するプロンプト

オプションパラメータ: - aspect_ratio: 画像のアスペクト比 - ASPECT_1_1 - ASPECT_4_3 - ASPECT_3_4 - ASPECT_16_9 - ASPECT_9_16 - model: 使用するモデル - V_1 - V_1_TURBO - V_2 - V_2_TURBO - magic_prompt_option: マジックプロンプトの設定 - AUTO - ON - OFF - style_type: 生成スタイル - negative_prompt: 除外したい要素の説明 - num_images: 生成する画像の数（1-8）

使用例

const result = await use_mcp_tool({
  server_name: "ideagram-mcp-server",
  tool_name: "generate_image",
  arguments: {
    prompt: "A beautiful sunset over mountains",
    aspect_ratio: "ASPECT_16_9",
    model: "V_2",
    num_images: 1
  }
});

? 開発

ディレクトリ構造

ideagram-mcp-server/
├── src/
│   ├── index.ts          # メインのサーバーコード
│   └── ideogram-client.ts # Ideogram APIクライアント
├── package.json
├── tsconfig.json
└── README.md

スクリプト

npm run build: TypeScriptのコンパイル
npm run watch: 開発モードでの実行（ファイル変更の監視）
npm run lint: コードのリント
npm test: テストの実行

? ライセンス

MIT

? コントリビューション

このリポジトリをフォーク
新しいブランチを作成 (git checkout -b feature/amazing-feature)
変更をコミット (git commit -m '✨ feat: Add amazing feature')
ブランチにプッシュ (git push origin feature/amazing-feature)
プルリクエストを作成

[
  {
    "description": "Generate an image using Ideogram AI",
    "inputSchema": {
      "properties": {
        "aspect_ratio": {
          "description": "The aspect ratio for the generated image",
          "enum": [
            "ASPECT_1_1",
            "ASPECT_4_3",
            "ASPECT_3_4",
            "ASPECT_16_9",
            "ASPECT_9_16"
          ],
          "type": "string"
        },
        "magic_prompt_option": {
          "description": "Whether to use magic prompt",
          "enum": [
            "AUTO",
            "ON",
            "OFF"
          ],
          "type": "string"
        },
        "model": {
          "description": "The model to use for generation",
          "enum": [
            "V_1",
            "V_1_TURBO",
            "V_2",
            "V_2_TURBO"
          ],
          "type": "string"
        },
        "negative_prompt": {
          "description": "Description of what to exclude from the image (must be in English)",
          "type": "string"
        },
        "num_images": {
          "description": "Number of images to generate (1-8)",
          "maximum": 8,
          "minimum": 1,
          "type": "number"
        },
        "prompt": {
          "description": "The prompt to use for generating the image (must be in English)",
          "type": "string"
        },
        "style_type": {
          "description": "The style type for generation",
          "type": "string"
        }
      },
      "required": [
        "prompt"
      ],
      "type": "object"
    },
    "name": "generate_image"
  }
]