Imagor MCP

Imagor MCP

imagor にテンプレートレイヤーを追加する MCP サーバーとスキルです。

エージェントは、OG カード、商品グリッド、引用、推薦文などのレイアウトを作成します。それを単一の imagor URL にコンパイルし、すでに稼働している imagor でレンダリングします。

レシピを見る »

クイックスタート

1. imagor を起動します。

docker run --rm -p 8000:8000 shumc/imagor -imagor-unsafe

起動したままにして、残りの作業には別のターミナルを使ってください。

安全でないモードは、試用するためのものです。本番環境では IMAGOR_SECRET を設定してください。 imagor のセキュリティに関するドキュメントをご覧ください。

2. MCP サーバーをインストールします。

brew trust cshum/tap && brew install imagor-mcp

3. クライアントを接続します。

クライアント	操作
VS Code	ここから追加 — ワンクリック
Claude Desktop	imagor-mcp.mcpb を開きます — ワンクリック
Cursor、Claude Code、Windsurf	下記のブロックを設定ファイルに追加します
Codex	同じ値を TOML 形式で ~/.codex/config.toml に追加します

{
  "mcpServers": {
    "imagor": {
      "command": "imagor-mcp",
      "env": { "IMAGOR_UNSAFE": "1", "IMAGOR_BASE_URL": "http://localhost:8000" }
    }
  }
}

この2つの設定は、ステップ1で起動した内容と一致させる必要があります。IMAGOR_UNSAFE はこのサーバーを同じモードで動作させ、IMAGOR_BASE_URL は imagor の場所を指定します。

VS Code はサーバーを servers の下に設定し、Codex は TOML を読み込むため、上記のブロックはどちらにもそのまま使えません。各クライアントの設定ファイルについてはセットアップをご覧ください。

4. 何かを作るよう依頼します。 レシピを見る — それぞれに貼り付けて使えるプロンプトが付いています。または、作りたい画像を説明してください。エージェントはツールを使って作成します。レイアウトを書き、レンダリングし、結果を確認して、URL を返します。imagor のパス構文を知っている必要はありません。ツールがパスを組み立て、動作しないパスは拒否します。

これでインストールは完了です。このプロジェクトは公式 MCP Registry に io.github.cshum/imagor-mcp としても登録されており、一部のクライアントでは名前でインストールできます。また、コンテナー版は ghcr.io/cshum/imagor-mcp として提供されていますが、異なるベース URL が必要です。詳しくはセットアップをご覧ください。Windows 用バイナリはリリースページにあります。

公開する前に、セキュリティをお読みください。このサーバーが信頼するものと、拒否するものについて説明しています。

さらに詳しく

• セットアップ — すべての設定、各クライアントが読み込む設定ファイル、公開前に必要な対応について説明します。
• リファレンス — サーバーが提供するすべてのツール、レイアウト形式、スキルについて説明します。
• クックブック — すぐに使えるレイアウトと、それぞれが解決される URL を紹介します。
• コントリビューション — ビルド、テスト、CLI について説明します。

ライセンス

MIT