glm-image-mcp-server

Z.AI の glm-image モデルを使用した画像生成 MCP サーバー

機能

• MCP サーバー: Claude Desktop やその他の MCP クライアントから画像を生成
• バッチ CLI: JSON 設定ファイルから複数の画像を一括生成
• 自動ダウンロード: 生成された画像は自動的にローカルに保存

インストール

npm からインストール

npm install @dondonudonjp/glm-image-mcp-server

ソースからビルド

git clone https://github.com/ex-takashima/glm-image-mcp-server.git
cd glm-image-mcp-server
npm install
npm run build

設定

環境変数

変数名	必須	デフォルト値	説明
Z_AI_API_KEY	はい	-	Z.AI の API キー
OUTPUT_DIRECTORY	いいえ	~/Downloads/glm-images	生成画像の保存先ディレクトリ

.env.example を参考に .env ファイルを作成してください：

cp .env.example .env
# .env を編集して API キーを設定

使用方法

MCP サーバー（Claude Desktop）

Claude Desktop の設定ファイル（claude_desktop_config.json）に以下を追加：

{
  "mcpServers": {
    "glm-image": {
      "command": "npx",
      "args": ["@dondonudonjp/glm-image-mcp-server"],
      "env": {
        "Z_AI_API_KEY": "your_api_key"
      }
    }
  }
}

ローカルビルドの場合：

{
  "mcpServers": {
    "glm-image": {
      "command": "node",
      "args": ["/path/to/glm-image-mcp-server/dist/index.js"],
      "env": {
        "Z_AI_API_KEY": "your_api_key"
      }
    }
  }
}

利用可能なツール

generate_image

• prompt（必須）: 生成する画像の説明テキスト
• quality（任意）: "hd"（デフォルト）または "standard"
• size_preset（任意）: アスペクト比プリセット（下記参照）
• custom_size（任意）: カスタムサイズ（例: "1536x1024"）※事前検証あり
• output_filename（任意）: 保存するファイル名

サイズ指定方法:

• size_preset と custom_size のどちらかを指定（両方指定時は size_preset 優先）
• どちらも未指定の場合は 1:1（1280x1280）がデフォルト

バッチ CLI

# バッチ処理を実行
npx @dondonudonjp/glm-image-mcp-server/dist/cli.js config.json

# または glm-image-batch コマンド（グローバルインストール時）
glm-image-batch config.json

# JSON 形式で出力
glm-image-batch config.json --format json

バッチ設定ファイルの形式

{
  "jobs": [
    {
      "prompt": "海に沈む美しい夕日",
      "quality": "hd",
      "size_preset": "16:9",
      "output_filename": "sunset.png"
    },
    {
      "prompt": "毛糸で遊ぶ猫",
      "custom_size": "1536x1024"
    },
    {
      "prompt": "山の風景"
    }
  ],
  "output_directory": "./output",
  "concurrency": 3
}

終了コード

• 0: すべてのジョブが正常に完了
• 1: 1つ以上のジョブが失敗

開発

# ビルド
npm run build

# ウォッチモード
npm run dev

# MCP インスペクターでテスト
npx @anthropic/mcp-inspector dist/index.js

API リファレンス

Z.AI glm-image API

• エンドポイント: POST https://api.z.ai/api/paas/v4/images/generations
• モデル: glm-image
• 品質オプション: hd, standard

画像サイズ

サイズプリセット（size_preset）:

プリセット	解像度	用途
1:1	1280x1280	正方形（デフォルト）
3:2	1568x1056	横長写真
2:3	1056x1568	縦長写真
4:3	1472x1088	横長スタンダード
3:4	1088x1472	縦長スタンダード
16:9	1728x960	ワイドスクリーン
9:16	960x1728	スマホ縦画面

カスタムサイズ（custom_size）の制限:

• 幅・高さ: 1024px〜2048px
• 32で割り切れる値のみ
• 総ピクセル数: 最大 2^22 px（約419万ピクセル）
• 無効な値を指定した場合、API呼び出し前にエラーを返却

ライセンス

MIT