Image Gen Server

🚀 画像生成サーバー

画像生成サーバーは、即夢AIをベースにした画像生成サービスで、Cursor IDEとの統合を目的としています。このサービスは、テキスト記述に基づいて画像を生成し、ダウンロードと保存機能を提供します。

🚀 クイックスタート

この画像生成サーバーは、テキスト記述に基づいて画像を生成することができ、Cursor IDEなどのツールとの統合もサポートしています。以下のセクションでは、サーバーの機能特性、インストール方法、使用方法などについて詳しく説明します。

✨ 主な機能

1. 完全統合：CursorやClaudeなどのツールとのシームレスな統合をサポートします。
2. テキストから画像生成：テキスト記述を入力することで、高品質の画像を生成します。
3. 自動保存：画像ファイルを自動的に生成して保存します。
4. カスタムパス：画像を保存するディレクトリを設定できます。
5. 一括生成：一度に4枚の異なるスタイルの画像を生成します。

📦 インストール

1. Smithery CLIを使用したインストール

smith install image-gen-server

2. 手動インストール

1. プロジェクトリポジトリをクローンします：

   git clone https://github.com/your-username/image-gen-server.git
   cd image-gen-server
   

2. 依存関係をインストールします：
   • Python環境要件：Python 3.8以上を使用してください。
   • 依存関係のインストール：

     pip install fastmcp proxy[jimeng]
     

3. プロジェクトを構成します：
   • server.py ファイルの IMG_SAVA_FOLDER 変数を変更して、デフォルトの保存パスを設定します。
   • config.json ファイルを構成して、即夢AIのAPIキーを追加します。

📚 ドキュメント

Cursorでの統合

1. Cursor設定を開く

• メニューバーの Cursor > Settings をクリックします。

2. MCPサーバーを追加する

• Tools セクションに移動し、MCP Servers を選択します。
• Add Server ボタンをクリックします。
• 以下の情報を入力します：
  • Name: Image-Gen-Server
  • Command:

    uv run --with fastmcp fastmcp run D:/path/to/server.py
    

  • Working Directory: サーバースクリプトがあるディレクトリに設定します。

3. 設定を完了する

• Add をクリックして、サーバーの追加を完了します。

使用方法

1. CursorのAgentモードで：

   • 例1：プロジェクトの要件に基づいて製品のロゴを生成し、プロジェクトディレクトリの images フォルダに保存します。
   • 例2：ウェブサイトのトップページ用のバナー画像を作成します。

2. インターフェースを呼び出す：

   from image_gen_server import generate_image
   
   images = generate_image(
       prompt="モダンでシンプルなスタイルのロゴをデザインしてください",
       save_path="path/to/images/logo.jpg",
       width=1024,
       height=1024
   )
   

技術的な実装

• server.py は fastmcp ライブラリを使用してMCPサーバー機能を実装し、CursorやClaudeにサービスを提供します。
• proxy.jimeng モジュールを呼び出して即夢AIとやり取りし、以下の機能をサポートしています：
  • 画像生成 (generate_images)
  • 同期対話補完 (create_completion)
  • ストリーミング対話補完 (create_completion_stream)
  • 複数アカウントトークンのサポート
  • 完全なエラー処理メカニズム

サンプルコード

# CursorのAgentモードで：
# 例1：製品のロゴを生成する
提供されたプロジェクトの要件に基づいて、製品のロゴを1枚生成し、プロジェクトディレクトリのimagesフォルダに保存してください。

# 例2：ウェブサイトのトップページのバナーをデザインする
プロジェクトの要件に基づいて、ウェブサイトのトップページを作成し、ヘッダーにバナー画像を配置してください。

ライセンス

このプロジェクトはMIT Licenseを採用しており、作者は凌封です。

よくある問題の解決

1. 設定完了後に黒いウィンドウが表示され、すぐに消える

   • 考えられる原因：
     • サーバーコマンドが正しく入力されていない場合、パスが正しいことを確認し、中文字を含まないようにし、パス区切り文字を統一してください。
     • 環境が正しくインストールされていない場合、すべての依存関係がインストールされていることを確認してください。
     • 使用するターミナルが設定と一致しない場合、異なるターミナル（Git Bash、Cmd、PowerShell、WSLなど）で実行してみてください。

2. サーバーをデバッグする

   uv run --with fastmcp fastmcp dev D:/path/to/server.py
   

   これにより、デバッグ画面 http://localhost:5173/ が開き、ブラウザで MCP Inspector を開いてデバッグできます。

詳細な情報は、プロジェクトのドキュメントと関連する技術資料を参照してください。