Skip to main content
Glama

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.

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

Prerequisites

Installation

Installing via Smithery

To install MCP Server Replicate for Claude Desktop automatically via Smithery:

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

Installing Manually

You can install the package directly from 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 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.

Usage

Once connected to Claude Desktop, you can:

  1. Generate images with natural language:

    Create a photorealistic mountain landscape at sunset with snow-capped peaks
  2. Browse your generations:

    Show me my recent image generations
  3. Search through generations:

    Find my landscape generations
  4. Check generation status:

    What's the status of my last generation?

Troubleshooting

Server not showing up in Claude Desktop

  1. Check the Claude Desktop logs:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
  1. Verify your configuration:

  • Make sure the path in claude_desktop_config.json is absolute

  • Ensure UV is installed and in your PATH

  • Check that your Replicate API key is set

  1. Try restarting Claude Desktop

For more detailed troubleshooting, see our Debugging Guide.

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

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Deploy Server
A
security – no known vulnerabilities
-
license - not tested
A
quality - confirmed to work

Related MCP Servers

  • -
    security
    -
    license
    -
    quality
    A high-performance FastAPI server supporting Model Context Protocol (MCP) for seamless integration with Large Language Models, featuring REST, GraphQL, and WebSocket APIs, along with real-time monitoring and vector search capabilities.
    Last updated -
    9
    MIT License
  • -
    security
    -
    license
    -
    quality
    A production-ready MCP server built with FastAPI, providing an enhanced tool registry for creating, managing, and documenting AI tools for Large Language Models (LLMs).
    Last updated -
    34
  • -
    security
    -
    license
    -
    quality
    A FastMCP server implementation that provides a standardized interface for accessing AI models hosted on Replicate's API, currently supporting image generation with customizable parameters.
    Last updated -
    3
    MIT License
  • -
    security
    -
    license
    -
    quality
    A FastAPI server implementing the Model Context Protocol (MCP) for structured tool use, providing utility tools including random number generation, image generation via Azure OpenAI DALL-E, and AI podcast generation.
    Last updated -

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/gerred/mcp-server-replicate'

If you have feedback or need assistance with the MCP directory API, please join our Discord server