画像ジェネレーターMCPサーバー

Replicate を使用してイメージを生成し、ユーザーがそれを保存できるようにする MCP サーバー。

コンポーネント

リソース

サーバーは、次の機能を備えた画像ストレージ システムを実装します。

• 生成された個々の画像にアクセスするためのカスタム image:// URI スキーム
• 各画像リソースには、プロンプト、作成日を含む説明、image/png mimetype に基づいた名前が付けられます。

プロンプト

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

• generate-image: 安定拡散法を使用して画像を生成するためのプロンプトを作成します。
  • 画像のスタイル（リアル/芸術的/抽象）を制御するためのオプションの「スタイル」引数
  • スタイル固有のガイダンスを含むプロンプトテンプレートを生成します

ツール

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

• generate-image: Replicateの安定拡散モデルを使用して画像を生成します
  • 必須の文字列引数として「prompt」を指定します
  • オプションパラメータには、「negative_prompt」、「width」、「height」、「num_inference_steps」、「guidance_scale」が含まれます。
  • 生成された画像とそのURLを返します
• save-image: 生成された画像をローカルファイルシステムに保存します
  • 必須の文字列引数として「image_url」と「prompt」を取ります
  • 画像の一意のIDを生成し、「generated_images」ディレクトリに保存します。
• list-saved-images: 保存されたすべての画像を一覧表示します
  • 保存されたすべての画像のリストをメタデータとサムネイルとともに返します

構成

APIトークンを複製する

この画像ジェネレータを使用するには、Replicate API トークンが必要です。

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

重要: APIトークンが誤って公開されるのを防ぐため、 .envファイルは.gitignoreによってバージョン管理から除外されます。機密情報をリポジトリにコミットしないでください。

環境設定

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

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

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

4. 上記のように.envファイルを設定します

クイックスタート

インストール

クロードデスクトップ

MacOS の場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

使用法

サーバーが起動したら、次の操作を実行できます。

1. 説明プロンプト付きの「generate-image」ツールを使用して画像を生成します
2. 生成された画像を、画像のURLとプロンプトを指定して「save-image」ツールで保存します。
3. 「list-saved-images」ツールを使用して保存したすべての画像を表示します
4. リソースリストから保存した画像にアクセスする

発達

建築と出版

配布用のパッケージを準備するには:

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

2. パッケージディストリビューションをビルドします。

これにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。

3. PyPI に公開:

注: 環境変数またはコマンド フラグを使用して PyPI 資格情報を設定する必要があります。

• トークン: --tokenまたはUV_PUBLISH_TOKEN
• またはユーザー名/パスワード: --username / UV_PUBLISH_USERNAMEおよび--password / UV_PUBLISH_PASSWORD

デバッグ

MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。

次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。

起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。