MCP Server Replicate

MCP Server Replicate

Replicate API 向けの FastMCP サーバー実装です。画像生成に重点を置き、リソースベースで AI モデルの推論にアクセスできます。

機能

• 🖼️ リソースベースの画像生成と管理
• 🔄 サブスクリプションによるリアルタイム更新
• 📝 テンプレート駆動型のパラメーター設定
• 🔍 包括的なモデルの検索と選択
• 🪝 外部通知のための Webhook 統合
• 🎨 最適な結果を得るための品質・スタイルプリセット
• 📊 進捗状況の追跡と状態の監視
• 🔒 安全な API キー管理

利用可能なプロンプト

このサーバーは、さまざまなタスク向けに特化したプロンプトをいくつか提供します。

テキストから画像（主要機能）

最も徹底的にテストされ、堅牢なプロンプトです。次の機能を備え、テキストによる説明から高品質な画像を生成できるよう最適化されています。

• 詳細なスタイル制御
• 品質プリセット（draft、balanced、quality、extreme）
• サイズとアスペクト比のカスタマイズ
• 進捗状況の追跡とリアルタイム更新

例：

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 経由で MCP Server Replicate を Claude Desktop に自動的にインストールするには：

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

Claude Desktop との連携

1. Claude Desktop の最新バージョンがインストールされていることを確認します
2. Claude Desktop の設定を開きます。

# 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. Replicate 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 に含まれていることを確認します
• Replicate 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 フックをインストールします。

pre-commit install

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

pytest

貢献

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

ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細については、LICENSEファイルをご覧ください。