Labsco
gerred logo

Replicate

★ 16

from gerred

Run AI models for tasks like image generation using the Replicate API.

🔥🔥🔥✓ VerifiedPaid serviceAdvanced setup
#automation#ai-image#git#monitoring

MCP Server Replicate

Python Version License Code Style Type Checker Ruff PyPI version smithery badge

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

Server Replicate MCP server

Features

  • 🖼️ Resource-based image generation and management
  • 🔄 Real-time updates through subscriptions
  • 📝 Template-driven parameter configuration
  • 🔍 Comprehensive model discovery and selection
  • 🪝 Webhook integration for external notifications
  • 🎨 Quality and style presets for optimal results
  • 📊 Progress tracking and status monitoring
  • 🔒 Secure API key management

Available Prompts

The server provides several specialized prompts for different tasks:

Text to Image (Primary)

Our most thoroughly tested and robust prompt. Optimized for generating high-quality images from text descriptions with:

  • Detailed style control
  • Quality presets (draft, balanced, quality, extreme)
  • Size and aspect ratio customization
  • Progress tracking and real-time updates

Example:

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

Other Prompts

  • Image to Image: Transform existing images (coming soon)
  • Model Selection: Get help choosing the right model for your task
  • Parameter Help: Understand and configure model parameters

Claude Desktop Integration

  1. Make sure you have the latest version of Claude Desktop installed
  2. Open your Claude Desktop configuration:
# macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
code %APPDATA%\Claude\claude_desktop_config.json
  1. Add the server configuration using one of these options:
{
  "globalShortcut": "Shift+Alt+A",
  "mcpServers": {
    "replicate": {
      "command": "uv",
      "args": ["tool", "run", "mcp-server-replicate"],
      "env": {
        "REPLICATE_API_TOKEN": "APITOKEN"
      },
      "cwd": "$PATH_TO_REPO"
    }
  }
}
  1. Set your Replicate API key:
# 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
  1. Restart Claude Desktop completely

You should now see the 🔨 icon in Claude Desktop, indicating that the MCP server is available.

Documentation

Development

  1. Clone the repository:
git clone https://github.com/gerred/mcp-server-replicate.git
cd mcp-server-replicate
  1. Install development dependencies:
uv pip install --system ".[dev]"
  1. Install pre-commit hooks:
pre-commit install
  1. Run tests:
pytest