@qmediat.io/ideogram-mcp

Ideogram V3 API 用の MCP サーバー — Claude Code、Claude Desktop、または任意の MCP クライアントから画像の生成、編集、リミックス、アップスケール、説明を行います。

このサーバーの特長

• 7つのツール — Ideogram V3 の全機能をカバー（生成、編集、リミックス、リフレーム、背景置換、アップスケール、説明）

• セキュリティ最優先 — SSRF 保護、シンボリックリンク拒否、Content-Type 検証、パストラバーサル防止、Zod レスポンス検証（詳細）

• 2つのランタイム依存関係 — @modelcontextprotocol/sdk + zod。axios、form-data、HTTP ライブラリは不要

• ネイティブ Ideogram API — V3 エンドポイントを直接使用。fal.ai や Replicate を経由しない

• 本番環境で堅牢 — 指数バックオフによるリトライ、セーフティフィルタ処理、部分的な障害への耐性

Related MCP server: ideogram-mcp-server

クイックスタート

npm install -g @qmediat.io/ideogram-mcp

または直接使用:

npx @qmediat.io/ideogram-mcp

IDEOGRAM_API_KEY が必要です — ideogram.ai/manage-api で取得できます。

設定

Claude Code

~/.claude.json → mcpServers に追加:

{
  "ideogram": {
    "command": "npx",
    "args": ["-y", "@qmediat.io/ideogram-mcp"],
    "env": {
      "IDEOGRAM_API_KEY": "your-api-key",
      "IDEOGRAM_OUTPUT_DIR": "/tmp/ideogram-output"
    }
  }
}

Claude Desktop

claude_desktop_config.json に追加:

{
  "mcpServers": {
    "ideogram": {
      "command": "npx",
      "args": ["-y", "@qmediat.io/ideogram-mcp"],
      "env": {
        "IDEOGRAM_API_KEY": "your-api-key",
        "IDEOGRAM_OUTPUT_DIR": "/tmp/ideogram-output"
      }
    }
  }
}

環境変数

利用可能なツール

共通パラメータ

セキュリティ

このサーバーは、ゼロトラスト・最小依存のアプローチで設計されています:

• SSRF 保護 — HTTPS のみのダウンロード、ホスト名の許可リスト、リダイレクトのブロック

• シンボリックリンク拒否 — lstat() が読み取り前にユーザー作成のシンボリックリンクを拒否

• Content-Type 検証 — ダウンロードは image/* である必要があり、HTML/JSON エラーページを拒否

• Zod レスポンス検証 — API レスポンスはスキーマで解析され、盲目的な型キャストは行わない

• パストラバーサル防止 — 拡張子の許可リスト + path.relative() による包含チェック

詳細は SECURITY.md を参照してください。

開発

git clone https://github.com/qmediat/ideogram-mcp.git
cd ideogram-mcp
npm install
npm run build

ローカルで実行:

IDEOGRAM_API_KEY=your-key node dist/index.js

コントリビューション

アーキテクチャのガイドラインと PR の要件については CONTRIBUTING.md を参照してください。

ライセンス

MIT — Quantum Media Technologies