MCP Image Gen

🚀 画像生成器 MCP サーバー

このサーバーは、Replicate を使用して画像を生成する MCP サーバーで、ユーザーが生成した画像を保存することができます。

✨ 主な機能

リソース

このサーバーは画像保存システムを実装しており、以下の機能を備えています。

• カスタムの image:// URI スキームを使用して、個々の生成画像にアクセスすることができます。
• 各画像リソースには、プロンプトに基づく名前、作成日を含む説明、および image/png メディアタイプがあります。

プロンプト

サーバーは単一のプロンプトを提供します。

• generate-image：Stable Diffusion を使用して画像を生成するためのプロンプトです。
  • 画像のスタイル（リアリズム/アート/抽象）を制御するためのオプションの "style" パラメーターがあります。
  • スタイルに応じて、ガイダンス文を含むプロンプトテンプレートが生成されます。

ツール

このサーバーは3つのツールを実装しています。

• generate-image：Replicate の Stable Diffusion モデルを使用して画像を生成します。
  • 必須の文字列パラメーターとして "prompt" を受け取ります。
  • オプションのパラメーターには、"negative_prompt"、"width"、"height"、"num_inference_steps"、および "guidance_scale" があります。
  • 生成された画像とその URL を返します。
• save-image：生成された画像をローカルファイルシステムに保存します。
  • 必須の文字列パラメーターとして "image_url" と "prompt" を受け取ります。
  • 画像に一意の ID を生成し、"generated_images" ディレクトリに保存します。
• list-saved-images：保存されたすべての画像をリストします。
  • 保存されたすべての画像とそのメタデータおよびサムネイルのリストを返します。

📦 インストール

Replicate API Token

この画像生成器を使用するには、Replicate API Token が必要です。

1. Replicate でアカウントを作成します。
2. https://replicate.com/account から API Token を取得します。
3. 提供されている .env.example テンプレートに基づいて .env ファイルを作成します。

REPLICATE_API_TOKEN=your_replicate_api_token_here

⚠️ 重要提示

.env ファイルは .gitignore によってバージョン管理から除外されており、API Token の誤暴露を防ぐためです。決して機密情報をリポジトリにコミットしないでください。

環境設定

1. リポジトリをクローンします。

git clone https://github.com/yourusername/image-generator.git
cd image-generator

2. 仮想環境を作成してアクティブ化します。

# 使用 venv
python -m venv .venv
# Windows の場合
.venv\Scripts\activate
# macOS/Linux の場合
source .venv/bin/activate

3. 依存関係をインストールします。

pip install -r requirements.txt

4. 上記の説明に従って .env ファイルを設定します。

💻 使用例

クロードデスクトップの設定

• MacOS：~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json%

使用方法

サーバーが起動したら、以下のことができます。

1. "generate-image" ツールと説明的なプロンプトを使用して画像を生成します。
2. "save-image" ツールと画像 URL およびプロンプトを使用して、生成された画像を保存します。
3. "list-saved-images" ツールを使用して、保存されたすべての画像を表示します。
4. リソースリストを通じて、保存された画像にアクセスします。

📚 ドキュメント

ビルドと公開

配布パッケージを準備するには、以下の手順を実行します。

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. パッケージのリリースバージョンをビルドします。

uv build

これにより、dist/ ディレクトリにソースコードとバイナリパッケージが作成されます。

3. PyPI に公開します。

uv publish

注意：PyPI の認証情報は、環境変数またはコマンドライン引数で設定する必要があります。

• Token：--token または REPOSITORY_TOKEN
• リポジトリ URL：--repository-url（デフォルトは https://upload.pypi.org/）

デバッグ

画像生成器をデバッグするには、以下の手順を実行します。

1. ターミナルでサーバーを起動します。
2. http://localhost:8000 を開いて、MCP ダッシュボードにアクセスします。
3. "image-generator" サービスを使用してインタラクションします。