Ideogram Images

🚀 🎨 Ideogram MCP サーバー

Ideogram API を使用して画像生成機能を提供する Model Context Protocol (MCP) サーバーです。このサーバーにより、ユーザーは指定したプロンプトに基づいて画像を生成することができます。

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

✨ 主な機能

• プロンプトに基づいて画像を生成します。
• 以下のようなカスタマイズ可能なパラメーターがあります。
  • 画像のアスペクト比
  • 使用するモデル
  • マジックプロンプトオプション
  • 生成する画像のスタイルタイプ
  • 生成から除外する内容の記述（ネガティブプロンプト）
  • 生成する画像の枚数

📦 インストール

1. 必要な依存関係をインストールします。

npm install

2. 環境変数を設定します。.env ファイルを作成し、以下の内容を追加します。

IDEOGRAM_API_KEY=your_api_key_here

3. ビルドします。

npm run build

4. （オプション）グローバルにインストールします。

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",
  parameters: {
    prompt: "a beautiful sunset over the mountains"
  }
});

📚 ドキュメント

開発手順

1. リポジトリをクローンします。

git clone https://github.com/sunwood-ai-labs/ideagram-mcp-server.git
cd ideagram-mcp-server

2. 依存関係をインストールします。

npm install

3. 開発サーバーを起動します。

npm run dev

4. プロジェクトをビルドします。

npm run build

5. テストを実行します。

npm test

貢献の仕方

1. リポジトリをフォークし、新しいブランチを作成します。

git checkout -b feature/new-feature

2. 変更をコミットし、リモートリポジトリにプッシュします。

git add .
git commit -m "添加新功能"
git push origin feature/new-feature

3. メインブランチに対して Pull Request を作成します。