local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Serves as a FastMCP server implementation for the Replicate API, providing resource-based access to AI model inference with a focus on image generation.

MCP サーバー複製

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

特徴

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

利用可能なプロンプト

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

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

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

詳細なスタイルコントロール
品質プリセット（ドラフト、バランス、品質、エクストリーム）
サイズとアスペクト比のカスタマイズ
進捗状況の追跡とリアルタイム更新

例：

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

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

Claude Desktopの最新バージョンがインストールされていることを確認してください
Claude デスクトップ構成を開きます。

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

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

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

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

レプリケート 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

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

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

使用法

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

自然言語で画像を生成します:
Create a photorealistic mountain landscape at sunset with snow-capped peaks
世代を閲覧する:
Show me my recent image generations
世代別に検索:
Find my landscape generations
生成ステータスを確認します:
What's the status of my last generation?

トラブルシューティング

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

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

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

設定を確認します。

claude_desktop_config.jsonのパスが絶対パスであることを確認してください
UVがインストールされ、PATHに含まれていることを確認してください
レプリケートAPIキーが設定されていることを確認してください

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

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

ドキュメント

発達

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

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

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

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

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

pre-commit install

テストを実行します:

pytest

貢献

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

ライセンス

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

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

View all tools

AI モデル推論へのリソースベースのアクセスを容易にする FastMCP サーバー実装。Replicate API による画像生成に重点を置き、リアルタイム更新、Webhook 統合、安全な API キー管理などの機能を備えています。

Related Resources

Reddit Discussion about this server