Imagegen Go

🚀 画像生成サーバー（imagegen - go）MCP サービス

このサービスは、MCP（モデル制御プロトコル）に基づく画像生成サーバーで、OpenAI の DALL - E API を使用して画像を生成します。

🚀 クイックスタート

この画像生成サーバーを使用する前に、いくつかの準備が必要です。以下の手順に従ってセットアップしてください。

✨ 主な機能

• MCP プロトコルを使用して、OpenAI の DALL - E API を通じて画像を生成します。
• 複数のテストスクリプトを提供し、MCP サーバーのデバッグを容易にします。
• 生成された画像を指定されたパスに保存できます。

📦 インストール

環境要件

• Go 1.23.5 以上
• OpenAI API キー

環境変数の設定

使用する前に、OpenAI API キーを設定してください。

export OPENAI_API_KEY="あなたのOpenAI APIキー"

コンパイル

プロジェクトを再コンパイルする必要がある場合は、次のコマンドを実行します。

go build -o bin/imagegen-go main/*.go

💻 使用例

基本的な使用法

テストスクリプトの実行

このプロジェクトには、MCP サーバーをデバッグするための複数のテストスクリプトが用意されています。

1. 基本テスト

初期化、ツールリストの取得、画像生成を含む基本テストを実行します。

./test_mcp.sh

2. 詳細デバッグ

ログとレスポンスをファイルに保存して詳細なデバッグを行います。

./debug_mcp.sh

3. 対話型テスト

カスタムのプロンプトを入力できる対話型テストを実行します。

./interactive_test.sh

4. 単一リクエストテスト

単一のリクエストをテストします。

# 初期化リクエスト
./test_single_request.sh init

# ツールリストの取得
./test_single_request.sh list

# 画像生成
./test_single_request.sh generate "可愛い猫" 1024 1024

高度な使用法

デバッグ手順

1. 環境変数の設定：

export OPENAI_API_KEY="あなたのOpenAI APIキー"

2. 初期化リクエストの実行：

./test_single_request.sh init

3. ツールリストの取得：

./test_single_request.sh list

4. 画像生成：

./test_single_request.sh generate "あなたのプロンプト" [幅] [高さ]

5. ログの確認：

cat logs/single_request_*.log

📚 ドキュメント

MCP プロトコル

MCP は、JSON - RPC 2.0 に基づくプロトコルで、モデルとツール間の通信に使用されます。このサーバーは以下の MCP メソッドを実装しています。

• initialize - サーバーの初期化
• tools/list - 利用可能なツールのリストを取得
• tools/call - ツールを呼び出す（画像生成）
• resources/list - 利用可能なリソースのリストを取得
• prompts/list - 利用可能なプロンプトのリストを取得

画像生成ツール

このサーバーは、generate - image という名前の画像生成ツールを提供しています。パラメータは以下の通りです。

プロジェクト構造

imagegen - go/
├── bin/                # コンパイル後のバイナリファイル
├── main/              # メインプログラムディレクトリ
├── test/             # テストスクリプトディレクトリ
└── logs/             # ログファイルディレクトリ

🔧 技術詳細

すべてのテストスクリプトは、ログを logs ディレクトリに保存します。これにより、ログの確認と分析が容易になります。

📄 ライセンス

原文書にライセンス情報は記載されていません。

⚠️ 重要提示

• OpenAI API キーの有効性と安全性を確保してください。
• 画像生成は、API の制限（回数やサイズなど）を受ける場合があります。
• 生成された画像は、指定された destination パスに保存されます。デフォルトはユーザーの Downloads ディレクトリです。