Image Generation (Replicate)

🚀 画像生成器 MCP サーバー

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

🚀 クイックスタート

この画像生成器 MCP サーバーを使用することで、Stable Diffusion を用いた画像生成と保存が可能です。以下にサーバーの主な機能や設定方法を説明します。

✨ 主な機能

🔍 リソース

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

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

💬 プロンプト

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

• 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 ファイルを設定します。

Claude Desktop

MacOS 上では：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows 上では：%APPDATA%/Claude/claude_desktop_config.json%