# Gemini 画像生成器 MCP サーバー (修正版)

Claude DesktopでGoogle の Gemini AIを使用して高品質な画像を生成・編集できる MCP サーバーです。

## 🚀 主な特徴

- **テキストから画像生成**: Gemini 2.0 Flash を使用したテキスト→画像変換
- **画像変換**: 既存の画像をテキストプロンプトで修正
- **多言語対応**: 日本語・韓国語・中国語プロンプトの自動英語翻訳・最適化
- **AI ファイル名生成**: プロンプト基準でファイル名を自動生成
- **ローカル保存**: 生成された画像を指定フォルダに自動保存
- **Claude チャット内表示**: 生成された画像をチャット画面で直接確認

## 🛠️ インストール要件

- **Python 3.11 以上**
- **Google Gemini API キー**
- **Claude Desktop** またはその他 MCP 互換クライアント

## 📋 ステップ1: Gemini API キー発行

1. [Google AI Studio API Keys ページ](https://aistudio.google.com/apikey) にアクセス
2. Google アカウントでログイン
3. **"Create API Key"** をクリック
4. 生成された API キーをコピー（後で使用）

## 💾 ステップ2: MCP サーバーインストール

### 自動インストール（推奨）
```bash
# リポジトリクローン
git clone https://github.com/my13each/mcp-server-gemini-image-generator-fixed.git
cd mcp-server-gemini-image-generator-fixed

# 仮想環境作成・有効化
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# パッケージインストール
pip install -e .
```

### インストール確認
```bash
# サーバーが正常実行されるかテスト
python -m mcp_server_gemini_image_generator.server
```
`Starting Gemini Image Generator MCP server...` メッセージが表示されれば成功！（Ctrl+C で終了）

## ⚙️ ステップ3: Claude Desktop 設定

### 設定ファイル場所
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

### 設定ファイル内容
```json
{
  "mcpServers": {
    "gemini-image-generator": {
      "command": "/Users/ユーザー名/mcp-server-gemini-image-generator-fixed/venv/bin/python",
      "args": [
        "-m", "mcp_server_gemini_image_generator.server"
      ],
      "env": {
        "GEMINI_API_KEY": "ここに実際のAPIキーを入力",
        "OUTPUT_IMAGE_PATH": "/Users/ユーザー名/Pictures/ai_generated"
      }
    }
  }
}
```

### 実際の設定例
```json
{
  "mcpServers": {
    "gemini-image-generator": {
      "command": "/Users/ユーザー名/mcp-server-gemini-image-generator-fixed/venv/bin/python",
      "args": [
        "-m", "mcp_server_gemini_image_generator.server"
      ],
      "env": {
        "GEMINI_API_KEY": "AIzaSy...(実際のAPIキー)",
        "OUTPUT_IMAGE_PATH": "/Users/ユーザー名/Pictures/ai_generated"
      }
    }
  }
}
```

### 🚨 重要事項
1. **絶対パス使用**: すべてのパスは完全パスで入力
2. **API キー置換**: `ここに実際のAPIキーを入力` 部分を発行した実際のキーに置換
3. **画像フォルダ**: `OUTPUT_IMAGE_PATH` に指定したフォルダが事前に作成されている必要があります

### 画像保存フォルダ作成
```bash
mkdir -p ~/Pictures/ai_generated
```

## 🎯 ステップ4: 実行・テスト

1. **Claude Desktop 再起動**: 設定後完全に終了して再起動
2. **接続確認**: Claude Desktop で MCP サーバーが接続されたか確認
3. **テスト**: 「猫の絵を描いて」とリクエストしてみる

## 📖 使用方法

### 画像生成
```
美しい富士山と桜がある日本の風景を描いて
```

### 画像変換（ファイルパス）
```
/Users/username/image.jpg この画像に虹を追加して
```

### 画像変換（アップロード）
画像を Claude にアップロード後:
```
この画像を夜の風景に変えて
```

## 🔧 トラブルシューティング

### サーバー接続失敗
1. **ログ確認**: Claude Desktop のログフォルダで `gemini-image-generator.log` を確認
2. **パス確認**: `claude_desktop_config.json` の Python パスが正確か確認
3. **権限確認**: 画像保存フォルダに書き込み権限があるか確認

### API キーエラー
1. **キー有効性**: Google AI Studio で API キーが有効化されているか確認
2. **引用符確認**: 設定ファイルで API キーが引用符で囲まれているか確認

### 手動テスト
```bash
cd ~/mcp-server-gemini-image-generator-fixed
source venv/bin/activate
export GEMINI_API_KEY="実際のAPIキー"
export OUTPUT_IMAGE_PATH="~/Pictures/ai_generated"
python -m mcp_server_gemini_image_generator.server
```

## 📊 提供ツール

### 1. `generate_image_from_text`
- **機能**: テキストプロンプトで新しい画像生成
- **入力**: 画像説明テキスト
- **出力**: 生成された画像（Claude チャット内表示 + ローカル保存）

### 2. `transform_image_from_file`
- **機能**: ファイルパスの画像をテキストプロンプトで変換
- **入力**: 画像ファイルパス、変換プロンプト
- **出力**: 変換された画像（Claude チャット内表示 + ローカル保存）

### 3. `transform_image_from_encoded`
- **機能**: Base64 エンコードされた画像をテキストプロンプトで変換
- **入力**: Base64 画像データ、変換プロンプト
- **出力**: 変換された画像（Claude チャット内表示 + ローカル保存）

## 📝 オリジナルからの相違点

この修正版は元のリポジトリの以下の問題を解決しました:

- ❌ **元の問題**: JSON シリアル化エラー (`invalid utf-8 sequence`)
- ❌ **元の問題**: MCP ツールがバイナリデータ返却により実行失敗
- ✅ **修正事項**: ファイルパス返却で安定的な動作
- ✅ **修正事項**: Claude Desktop で完璧に動作
- ✅ **修正事項**: 生成された画像を Claude チャット内で直接確認可能

## 🤝 貢献・お問い合わせ

- **元のリポジトリ**: [qhdrl12/mcp-server-gemini-image-generator](https://github.com/qhdrl12/mcp-server-gemini-image-generator)
- **修正版**: [my13each/mcp-server-gemini-image-generator-fixed](https://github.com/my13each/mcp-server-gemini-image-generator-fixed)
- **問題報告**: GitHub Issues タブで問題を報告

## 📄 ライセンス

MIT License - 元のプロジェクトと同じ

---

**ヒント**: 初回設定時はステップごとに進め、問題が発生した場合はまずログファイルを確認してください！ 🚀