OpenAI Image Generation MCP

OpenAI Image Generation MCP

OpenAI 画像生成 API 用の Model Context Protocol（MCP）サーバーです。この MCP を使用すると、Claude などの AI アシスタントが OpenAI の GPT-image-1 モデルを使って画像を生成・編集できます。

目次

• 機能
• インストール
• クイックスタート
• 設定
• 詳細ドキュメント
• ライセンス

機能

• OpenAI の画像生成モデルを使用して画像を生成
• テキストプロンプトと任意のマスクを使用して既存の画像を編集
• 生成した画像をローカルストレージに自動保存
• 生成した画像を Cloudflare ImgBed に任意でアップロード
• サーバーの状態を確認するヘルスチェックエンドポイント
• API キーを指定する複数の方法（環境変数、コマンドライン、直接指定）

インストール

1. リポジトリをクローンし、依存関係をインストールします。

git clone https://github.com/yourusername/openai-image-gen-mcp.git
cd openai-image-gen-mcp
npm install

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

npm run build

クイックスタート

1. 実行スクリプトを使用する（本番環境に推奨）

フル機能の MCP サーバーを起動する最も簡単な方法です。

./run-with-key.sh

このスクリプトには API キーが埋め込まれており、すべての機能を備えた MCP サーバーを起動します。

2. API キーを直接指定する（テスト用）

node hardcoded-key.js

これは、API キーをコードに直接埋め込んだ簡易版です。

3. 環境変数を使用する

export OPENAI_API_KEY=your-api-key
./start.sh

設定

Claude MCP の設定

Claude をこの MCP に接続するには、次の設定ファイルを使用します。

{
  "mcpServers": {
    "openai-image-gen": {
      "command": "node",
      "args": ["/Users/jerry/openai-image-gen-mcp/build/index.js"]
    }
  }
}

⚠️ 重要：本番環境では、フル機能のコンパイル済みバージョン（build/index.js）を使用してください。簡易版はテストおよび学習目的専用です。

利用可能なツール

この MCP は Claude に次のツールを提供します。

1. oai_generate_image - テキストプロンプトから画像を生成します
2. oai_edit_image - テキストプロンプトを使用して既存の画像を編集します
3. health_check - サーバーの健全性状態を確認します

Claude での使用例：

Generate an image of a sunset over mountains with a lake in the foreground.

Claude は画像の作成に適切な MCP ツールを使用します。

詳細ドキュメント

詳しくは、次のドキュメントを参照してください。

• アーキテクチャ - システム設計とコンポーネント
• パイプライン - 開発およびリクエスト処理のパイプライン
• ガイドライン - ベストプラクティスと使用ガイドライン
• 解説 - コードと API の詳細な解説

ディレクトリ構成

openai-image-gen-mcp/
├── build/              # Compiled JavaScript code
├── docs/               # Documentation files
├── output/             # Generated images
├── src/                # TypeScript source code
│   ├── config.js       # Configuration management
│   └── index.ts        # Main MCP server implementation
├── *.sh                # Helper scripts
├── *.js                # Simplified versions and utilities
└── *.json              # Configuration files

トラブルシューティング

問題が発生した場合は、次の点を確認してください。

1. API キーが有効で、正しい形式であることを確認します
2. 出力ディレクトリが存在し、書き込み可能であることを確認します
3. ヘルスチェックを実行して、サーバーの状態を確認します
4. 詳細なエラー情報について、ログを確認します
5. 問題を切り分けるため、簡易版を試します

詳しくは、ガイドラインのトラブルシューティングのセクションを参照してください。