Replicate

🚀 複製 MCP サーバ

Replicate 用に実装された Model Context Protocol (MCP) サーバです。シンプルなツールベースのインターフェイスで Replicate モデルを実行できます。

🚀 クイックスタート

サーバのインストール

npm install -g mcp-replicate

Replicate API トークンの取得

• Replicate API トークンページにアクセスします。
• トークンがない場合は、新しいトークンを作成します。
• トークンをコピーして次の手順で使用します。

Claude デスクトップ版の設定

• Claude デスクトップ設定（⌘,）を開きます。
• サイドバーで「開発者」セクションを選択します。
• 「編集設定」をクリックして設定ファイルを開きます。
• 以下の設定を追加し、your_token_here を実際の Replicate API トークンに置き換えます。

{
  "mcpServers": {
    "replicate": {
      "command": "mcp-replicate",
      "env": {
        "REPLICATE_API_TOKEN": "your_token_here"
      }
    }
  }
}

Claude デスクトップ版の起動

Claude デスクトップ版を起動すると、新しいチャットウィンドウの右下に 🔨 ハンマーアイコンが表示され、ツールが使用可能になります。

（他の MCP クライアント、例えば Cursor、Cline、Continue を使用することもできます。）

📦 インストールの代替方法

ソースコードからのインストール

git clone https://github.com/deepfates/mcp-replicate
cd mcp-replicate
npm install
npm run build
npm start

npx での実行

npx mcp-replicate

✨ 主な機能

モデル

• セマンティック検索でモデルを検索します。
• 利用可能なモデルとコレクションを閲覧します。
• 特定のモデルの詳細情報とバージョンを取得します。

予測

• テキストまたは構造化入力を使用して予測を作成します。
• 予測の状態を追跡します。
• 実行中の予測をキャンセルします。
• 最近の予測記録を一覧表示します。

画像処理

• ブラウザで生成された画像を表示します。
• パフォーマンス向上のために画像キャッシュを管理します。

📚 設定

サーバを正常に動作させるには、Replicate API トークンが必要です。Replicate から取得できます。

トークンを提供する方法は以下の 2 つがあります。

1. Claude デスクトップ版での設定（推奨）

クイックスタートのセクションに示されているように、Claude デスクトップ版の設定に追加します。

{
  "mcpServers": {
    "replicate": {
      "command": "mcp-replicate",
      "env": {
        "REPLICATE_API_TOKEN": "your_token_here"
      }
    }
  }
}

2. 環境変数としての設定

他の MCP クライアントを使用する場合は、環境変数として設定できます。

export REPLICATE_API_TOKEN=your_token_here

💻 使用例

モデルツール

• search_models：セマンティック検索でモデルを検索します。
• list_models：利用可能なモデルを閲覧します。
• get_model：特定のモデルの詳細情報を取得します。
• list_collections：モデルコレクションを閲覧します。
• get_collection：特定のコレクションの詳細情報を取得します。

予測ツール

• create_prediction：入力を使用して予測を作成します。
• get_prediction_status：予測の状態を取得します。
• cancel_prediction：実行中の予測をキャンセルします。
• list_predictions：最近の予測記録を一覧表示します。

🔧 トラブルシューティング

問題が発生した場合は、以下を確認してください。

1. REPLICATE_API_TOKEN が正しく設定されていることを確認します。
2. Replicate サービスと通信するために、インターネット接続が正常であることを確認します。
3. コンソール出力を確認して、詳細なエラー情報を取得します。

📚 開発

このプロジェクトに貢献したり、カスタム開発を行う場合は、GitHub リポジトリ のドキュメントとガイドを参照してください。

📋 要件

• システムに Node.js と npm がインストールされている必要があります。
• 有効な Replicate API トークンが必要です。
• 最適な体験を得るために、最新のブラウザの使用をおすすめします。