Grok2 Image MCP Server

Name: Grok2 Image MCP Server
Author: fl0w1nd

ローカル

github.com/fl0w1ndメディア・デザイン292 週間前に更新

リポジトリ

Grok2 Image MCP Server について

Grok Image MCP は、xAI の画像 API を利用して画像の生成と編集を行う MCP サーバーです。stdio で動作し、MCP クライアントから Grok の画像モデルを使いたい利用者に向けられています。モデル、品質、結果の保存方法を選択できます。

主な機能

01generate_image と edit_image の 2 つのツール
02grok-imagine-image と 2.0 のモデル選択
03ローカル画像、URL、保存済みファイルを元画像として指定
04画像リンクまたは MCP のインライン画像として結果を返却
05xAI Files API への画像保存に対応

活用シーン

01MCP クライアントからプロンプトに基づいて画像を生成する
02ローカルの写真の背景を差し替えるなど編集を行う
03生成した画像を保存し、後続の編集で再利用する

MCP 対応

本プロジェクトは MCP サーバーであり、generate_image と edit_image のツールをクライアントに公開します。結果は structuredContent と MCP の image コンテンツブロックで返されます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "grok2-image": {
      "command": "npx",
      "args": [
        "-y",
        "grok-image-mcp"
      ],
      "env": {
        "XAIAPI_KEY": "<XAIAPI_KEY>"
      }
    }
  }
}

起動コマンドnpx -y grok-image-mcp

設定が必要な環境変数

XAIAPI_KEYシークレット

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmgrok-image-mcpstdio

ツール

掲載時のツール一覧 · 3 週間前に更新

パラメーター	型	必須	説明
prompt	string	はい	生成する画像のテキスト説明
n	integer	いいえ	生成する画像の数（1～10、デフォルト：1）
aspect_ratio	enum	いいえ	生成画像のアスペクト比（デフォルト：auto）1:1 \| 16:9 \| 9:16 \| 4:3 \| 3:4 \| 3:2 \| 2:3 \| 2:1 \| 1:2 \| 19.5:9 \| 9:19.5 \| 20:9 \| 9:20 \| auto
resolution	enum	いいえ	生成画像の解像度（デフォルト：1k）1k \| 2k

詳細

Grok Image MCP

English | 中文

xAI 画像 APIを使用して画像を生成・編集する MCP サーバーです。モデルと品質の選択、ローカル画像、保存済みファイル、stdio 経由でのインライン画像結果に対応しています。

Node.js 22.19+ と xAI API キーが必要です。

クイックスタート

MCP クライアントの設定に以下を追加してください。

{
  "mcpServers": {
    "grok_image": {
      "command": "npx",
      "args": ["-y", "grok-image-mcp"],
      "env": {
        "XAI_API_KEY": "your-xai-api-key"
      }
    }
  }
}

サーバーは generate_image と edit_image を提供します。generate_image の引数の例：

{
  "prompt": "A watercolor illustration of a quiet mountain lake",
  "model": "grok-imagine-image-2.0",
  "quality": "low",
  "aspect_ratio": "16:9"
}

モデルと品質

機能	`grok-imagine-image`	`grok-imagine-image-2.0`
デフォルトモデル	はい	呼び出しごとに選択するか、`XAI_IMAGE_MODEL` を設定
編集ごとの入力画像数	1–3	1–5
解像度	`1k`、`2k`	`1k`、`2k`
品質パラメーター	—	`low`、`medium`、`auto`
追加のアスペクト比	—	`21:9`、`5:2`

model 引数は XAI_IMAGE_MODEL を上書きします。デフォルトは grok-imagine-image です。

2.0 では、品質のデフォルトは auto です。生成では low、編集では medium になります。料金については xAI の料金を参照してください。

ツール

両方のツールで、以下のパラメーターを使用できます。

パラメーター	型	説明
`prompt`	文字列、必須	画像の説明または編集指示
`model`	文字列	上記2つのモデルのいずれか
`n`	整数	出力数、1～10。デフォルトは1
`aspect_ratio`	文字列	生成ではデフォルトが `auto`、編集では最初の入力に従います
`resolution`	文字列	`1k` または `2k`。デフォルトは `1k`
`quality`	文字列	2.0：`low`、`medium`、`auto`
`response_format`	文字列	`url`（デフォルト）または、インライン MCP 画像コンテンツ用の `b64_json`
`storage_options`	オブジェクト	生成した画像を Files API に保存します

アスペクト比：1:1、16:9、9:16、4:3、3:4、3:2、2:3、2:1、1:2、19.5:9、9:19.5、20:9、9:20、auto。2.0 では、さらに 21:9 と 5:2 に対応しています。

編集

edit_image では、以下のいずれかの入力画像リストを指定します。

image_urls：公開 URL、base64 データ URI、またはローカルパスの順序付き配列です。
images：{ "url": "..." } または { "file_id": "..." } オブジェクトの順序付き配列です。url にはデータ URI とローカルパスも指定できます。

{
  "prompt": "Replace the background with a snowy forest",
  "image_urls": ["/absolute/path/to/photo.png"]
}

ローカルファイルは PNG、JPEG、WebP に対応しています。相対パスはサーバーの作業ディレクトリを基準に解決されます。

結果

structuredContent.images には、画像 URL、修正されたプロンプト、MIME タイプ、保存済みファイルのメタデータが含まれます。xAI から返される場合は、モデル、品質、使用状況も含まれます。

url：一時的な画像リンクです。Markdown としても返されます。画像を保存するには storage_options を使用してください。
b64_json：MCP の image コンテンツブロックです。対応する構造化エントリーでは inline: true が設定されます。

画像を保存して再利用する

いずれかのツールに storage_options を追加すると、出力を xAI Files API に保存できます。

{
  "prompt": "A small cabin in a pine forest",
  "model": "grok-imagine-image-2.0",
  "quality": "low",
  "storage_options": {
    "filename": "cabin.jpg",
    "expires_after": 86400
  }
}

これにより画像が1日間、非公開で保存されます。後続の編集では structuredContent.images[0].file_output.file_id を使用します。

{
  "prompt": "Change the season to winter",
  "model": "grok-imagine-image-2.0",
  "quality": "low",
  "images": [{ "file_id": "file-id-from-the-previous-result" }]
}

ストレージオプション	説明
`filename`	保存する画像に必須のファイル名
`expires_after`	ファイルの有効期間（秒）、3600～2592000。デフォルト：無期限
`public_url`	`true` にすると共有可能な公開リンクを作成します。デフォルト：非公開
`public_url.expires_after`	`public_url: { "expires_after": 86400 }` を使用してリンクの有効期間を設定します

詳細については、xAI のストレージに関するドキュメントを参照してください。

設定とネットワーク

環境変数	説明
`XAI_API_KEY`	xAI API キー。`XAIAPI_KEY` より優先されます
`XAIAPI_KEY`	代替の API キー変数
`XAI_IMAGE_MODEL`	デフォルトモデル。省略時は `grok-imagine-image`
`XAIAPI_BASE_URL`	API のベース URL。デフォルトは `https://api.x.ai/v1`
`XAI_TIMEOUT_MS`	リクエストのタイムアウト（ミリ秒）。デフォルトは `180000`
`HTTPS_PROXY`	API リクエスト用ネットワークプロキシ。`HTTP_PROXY` より優先されます
`HTTP_PROXY`	ネットワークプロキシ。例：`http://127.0.0.1:7890`
`IMAGE_PROXY_DOMAIN`	返された `imgen.x.ai` URL 用のリバースプロキシ。例：`https://images.example.com`

IMAGE_PROXY_DOMAIN では、パスとクエリ文字列を https://imgen.x.ai に転送するようリバースプロキシを設定してください。

生成に時間がかかる場合は、MCP クライアントのツールタイムアウトを XAI_TIMEOUT_MS 以上に設定してください。

開発

npm ci
npm test

ローカルビルドを使用するには、MCP クライアントが node を dist/index.js の絶対パスとともに実行するよう設定してください。

ライセンス

MIT

xAI 画像 API を利用した MCP サービスです。モデルと品質の選択、ローカル画像または保存済み画像の編集に対応し、画像リンクまたはインライン画像を返します。stdio トランスポートを使用します。

Node.js 22.19+ と xAI API キーが必要です。

クイックスタート

MCP クライアントに以下を追加します。

{
  "mcpServers": {
    "grok_image": {
      "command": "npx",
      "args": ["-y", "grok-image-mcp"],
      "env": {
        "XAI_API_KEY": "你的 xAI API 密钥"
      }
    }
  }
}

サービスは generate_image と edit_image の 2 つのツールを提供します。generate_image の呼び出し例：

{
  "prompt": "一幅宁静山间湖泊的水彩插画",
  "model": "grok-imagine-image-2.0",
  "quality": "low",
  "aspect_ratio": "16:9"
}

モデルと品質

機能	`grok-imagine-image`	`grok-imagine-image-2.0`
デフォルトモデル	はい	呼び出しごとに指定するか、`XAI_IMAGE_MODEL` を設定
編集元画像の数	1–3 枚	1–5 枚
解像度	`1k`、`2k`	`1k`、`2k`
品質パラメーター	—	`low`、`medium`、`auto`
追加のアスペクト比	—	`21:9`、`5:2`

呼び出し時の model は環境変数 XAI_IMAGE_MODEL より優先されます。デフォルト値は grok-imagine-image です。

2.0 の品質はデフォルトで auto です。生成では low、編集では medium に対応します。料金については xAI の料金をご覧ください。

ツールのパラメーター

両方のツールで以下のパラメーターを使用します。

パラメーター	型	説明
`prompt`	string、必須	画像の説明または編集指示
`model`	string	上表のいずれかのモデル
`n`	integer	出力数。1–10、デフォルトは 1
`aspect_ratio`	string	生成時のデフォルトは `auto`。編集時のデフォルトは最初の元画像に従います
`resolution`	string	`1k` または `2k`。デフォルトは `1k`
`quality`	string	2.0：`low`、`medium`、`auto`
`response_format`	string	デフォルトは `url`。`b64_json` は MCP ネイティブの画像コンテンツを返します
`storage_options`	object	出力を Files API に保存します

アスペクト比は 1:1、16:9、9:16、4:3、3:4、3:2、2:3、2:1、1:2、19.5:9、9:19.5、20:9、9:20、auto に対応しています。2.0 ではさらに 21:9、5:2 に対応しています。

画像の編集

edit_image の元画像リストには、次のいずれかの形式を使用します。

image_urls：公開 URL、base64 data URI、またはローカルパスを順番に指定します。
images：{ "url": "..." } または { "file_id": "..." } オブジェクトを順番に指定します。url では data URI とローカルパスも使用できます。

{
  "prompt": "将背景替换成雪中的森林",
  "image_urls": ["/absolute/path/to/photo.png"]
}

ローカルファイルは PNG、JPEG、WebP に対応しています。相対パスはサービスの作業ディレクトリを基準とします。

結果

structuredContent.images には画像 URL、修正されたプロンプト、MIME タイプ、ファイルの保存情報が含まれます。モデル、品質、使用量の情報は xAI の返却内容に含まれます。

url：一時的な画像リンクで、Markdown としても返されます。storage_options を使用すると画像を保存できます。
b64_json：MCP の image コンテンツブロックです。対応する構造化エントリーには inline: true と記されます。

画像の保存と再利用

いずれかのツールに storage_options を追加すると、出力を保存できます。

{
  "prompt": "松林中的一间小木屋",
  "model": "grok-imagine-image-2.0",
  "quality": "low",
  "storage_options": {
    "filename": "cabin.jpg",
    "expires_after": 86400
  }
}

上記の設定では、画像を非公開で 1 日間保存します。structuredContent.images[0].file_output.file_id からファイル ID を取得し、その後の編集で再利用します。

{
  "prompt": "将季节改成冬季",
  "model": "grok-imagine-image-2.0",
  "quality": "low",
  "images": [{ "file_id": "上一次返回的文件 ID" }]
}

ストレージオプション	説明
`filename`	必須。保存するファイル名
`expires_after`	ファイルの有効期間。3600–2592000 秒。デフォルトでは無期限に保存
`public_url`	`true` に設定すると公開共有リンクを作成します。デフォルトでは非公開で保存
`public_url.expires_after`	`public_url: { "expires_after": 86400 }` を使用して公開リンクの有効期間を指定します

詳しくは xAI ストレージのドキュメントをご覧ください。

環境変数とネットワーク

変数	説明
`XAI_API_KEY`	API キー。`XAIAPI_KEY` より優先されます
`XAIAPI_KEY`	API キーの別名
`XAI_IMAGE_MODEL`	デフォルトモデル。未設定時は `grok-imagine-image`
`XAIAPI_BASE_URL`	API のベース URL。デフォルトは `https://api.x.ai/v1`
`XAI_TIMEOUT_MS`	リクエストのタイムアウト（ミリ秒）。デフォルトは `180000`
`HTTPS_PROXY`	API のネットワークプロキシ。`HTTP_PROXY` より優先されます
`HTTP_PROXY`	API のネットワークプロキシ。例：`http://127.0.0.1:7890`
`IMAGE_PROXY_DOMAIN`	返される画像のリバースプロキシ URL。例：`https://images.example.com`

IMAGE_PROXY_DOMAIN を使用する場合、リバースプロキシはパスとクエリパラメーターを https://imgen.x.ai に転送する必要があります。

生成に時間がかかる場合は、MCP クライアントのツールタイムアウトを XAI_TIMEOUT_MS 以上に設定してください。

開発

npm ci
npm test

ローカルビルドを使用するには、MCP クライアントで node と dist/index.js の絶対パスを設定してください。

ライセンス

MIT

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

Grok2 Image MCP Server

Grok2 Image MCP Server について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

Grok Image MCP

クイックスタート

モデルと品質

ツール

編集

結果

画像を保存して再利用する

設定とネットワーク

開発

ライセンス

クイックスタート

モデルと品質

ツールのパラメーター

画像の編集

結果

画像の保存と再利用

環境変数とネットワーク

開発

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？