Image MCP Servers

画像 MCP サーバー

このプロジェクトは、HuggingFace および Replicate API と連携するツールを提供する SSE MCP サーバーを実装しており、画像生成とモデル管理に重点を置いています。MCP Core フレームワークを使用して構築され、AI モデルとのやり取りのための標準化されたインターフェースを提供します。以下では、セルフホストする手順を説明します。

機能

HuggingFace 連携

ツール	説明
モデル情報の取得	HuggingFace 上のモデルに関する詳細情報を取得します
モデルのサンプル画像を取得	モデルの README からサンプル画像を抽出します
README の取得	モデルの README の内容を取得します
モデルの検索	フィルタリングオプションを指定して HuggingFace 上のモデルを検索します
WhoAmI	現在の HuggingFace API トークンに関する情報を取得します

Replicate 連携

ツール	説明
画像の生成	Replicate のテキスト画像変換モデルを使用して画像を生成します
モデル情報の取得	Replicate 上のモデルに関する詳細情報を取得します
予測の取得	予測のステータスを確認し、出力を取得します
モデルの一覧表示	オプションのフィルタリングを指定して Replicate で利用可能なモデルを一覧表示します
WhoAmI	現在の Replicate API トークンに関する情報を取得します

はじめに

前提条件

• Rust（2024 edition）
• Docker（任意。コンテナ化したデプロイに使用）

インストール

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

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

2. .env.example を基に .env ファイルを作成します。

   cp .env.example .env
   

3. .env ファイルに API トークンを追加します。

   HF_API_TOKEN="your_huggingface_token"
   REPLICATE_API_TOKEN="your_replicate_token"
   

4. プロジェクトをビルドします。

   cargo build
   

サーバーの実行

cargo run

サーバーは SERVER_PORT 環境変数で指定されたポート（デフォルト：3000）で起動します。

Docker の使用

このプロジェクトには、簡単にデプロイできるよう Docker サポートが含まれています。

# Start the service
just docker-up service

# Stop the service
just docker-down service

設定

サーバーは環境変数を使用して設定できます。

• SERVER_NAME：サーバー名（デフォルト："image-mcp-servers"）
• SERVER_VERSION：サーバーのバージョン（デフォルト："0.1.0"）
• SERVER_PORT：サーバーを実行するポート（デフォルト：3000）
• HF_API_TOKEN：HuggingFace API トークン
• REPLICATE_API_TOKEN：Replicate API トークン

機能

このプロジェクトでは、次の 2 つの主な機能セットを有効または無効にできます。

• huggingface：HuggingFace API 連携を有効にします
• replicate：Replicate API 連携を有効にします

デフォルトでは、どの機能も有効になっていません。特定の機能を指定してビルドできます。

# Build with only HuggingFace
cargo build --no-default-features --features huggingface

# Build with only Replicate
cargo build --no-default-features --features replicate

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルを参照してください。

謝辞

• MCP Core - このサーバーの構築に使用したフレームワーク
• HuggingFace - 画像生成モデルの提供
• Replicate - 画像生成 API の提供