MCP サーバー複製

Replicate API 用の FastMCP サーバー実装。画像生成に重点を置いた AI モデル推論へのリソースベースのアクセスを提供します。

特徴

• 🖼️ リソースベースの画像生成と管理

• 🔄 サブスクリプションによるリアルタイム更新

• 📝 テンプレート駆動型パラメータ設定

• 🔍 包括的なモデルの発見と選択

• 🪝 外部通知のためのWebhook統合

• 🎨 最適な結果を得るための品質とスタイルのプリセット

• 📊 進捗状況の追跡とステータスの監視

• 🔒 安全なAPIキー管理

Related MCP server: MCP Server for Replicate

利用可能なプロンプト

サーバーは、さまざまなタスクに対していくつかの特殊なプロンプトを提供します。

テキストから画像へ（プライマリ）

徹底的にテストされた堅牢なプロンプト。以下の機能により、テキストの説明から高品質な画像を生成するために最適化されています。

• 詳細なスタイルコントロール

• 品質プリセット（ドラフト、バランス、品質、エクストリーム）

• サイズとアスペクト比のカスタマイズ

• 進捗状況の追跡とリアルタイム更新

例：

Create a photorealistic mountain landscape at sunset with snow-capped peaks, quality level: quality, style: photorealistic

その他のプロンプト

• 画像から画像へ：既存の画像を変換します（近日公開予定）

• モデルの選択: タスクに適したモデルの選択を支援します

• パラメータヘルプ: モデルパラメータを理解して設定する

前提条件

• Python 3.11以上

• Replicate API キー ( https://replicate.com/accountで取得)

• 依存関係管理のためのUV

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の MCP Server Replicate を自動的にインストールするには:

npx -y @smithery/cli install @gerred/mcp-server-replicate --client claude

手動でインストールする

PyPI から直接パッケージをインストールできます。

# Using UV (recommended)
uv pip install mcp-server-replicate

# Using UVX for isolated environments
uvx install mcp-server-replicate

# Using pip
pip install mcp-server-replicate

クロードデスクトップ統合

1. Claude Desktopの最新バージョンがインストールされていることを確認してください

2. Claude デスクトップ構成を開きます。

# macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
code %APPDATA%\Claude\claude_desktop_config.json

3. 次のいずれかのオプションを使用してサーバー構成を追加します。

{
  "globalShortcut": "Shift+Alt+A",
  "mcpServers": {
    "replicate": {
      "command": "uv",
      "args": ["tool", "run", "mcp-server-replicate"],
      "env": {
        "REPLICATE_API_TOKEN": "APITOKEN"
      },
      "cwd": "$PATH_TO_REPO"
    }
  }
}

4. レプリケート API キーを設定します。

# Option 1: Set in your environment
export REPLICATE_API_TOKEN=your_api_key_here

# Option 2: Create a .env file in your home directory
echo "REPLICATE_API_TOKEN=your_api_key_here" > ~/.env

5. Claude Desktopを完全に再起動します

Claude Desktop に 🔨 アイコンが表示され、MCP サーバーが利用可能であることがわかります。

使用法

Claude Desktop に接続すると、次のことが可能になります。

1. 自然言語で画像を生成します:

   Create a photorealistic mountain landscape at sunset with snow-capped peaks

2. 世代を閲覧する:

   Show me my recent image generations

3. 世代別に検索:

   Find my landscape generations

4. 生成ステータスを確認します:

   What's the status of my last generation?

トラブルシューティング

Claude Desktop にサーバーが表示されない

1. Claude Desktop のログを確認します。

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

2. 設定を確認します。

• claude_desktop_config.jsonのパスが絶対パスであることを確認してください

• UVがインストールされ、PATHに含まれていることを確認してください

• レプリケートAPIキーが設定されていることを確認してください

3. Claude Desktopを再起動してみてください

より詳細なトラブルシューティングについては、デバッグ ガイドを参照してください。

ドキュメント

• 実施計画

• 貢献ガイド

• APIリファレンス

• リソースシステム

• テンプレートシステム

発達

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

git clone https://github.com/gerred/mcp-server-replicate.git
cd mcp-server-replicate

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

uv pip install --system ".[dev]"

3. 事前コミットフックをインストールします。

pre-commit install

4. テストを実行します:

pytest

貢献

貢献を歓迎します！詳細については貢献ガイドをご覧ください。

ライセンス

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