Skip to main content
Glama
enesjakozh

MCP Server Replicate

by gerred
GitHub
Python
16
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A FastMCP server implementation that facilitates resource-based access to AI model inference, focusing on image generation through the Replicate API, with features like real-time updates, webhook integration, and secure API key management.

  1. Features
    1. Available Prompts
      1. Text to Image (Primary)
      2. Other Prompts
    2. Prerequisites
      1. Installation
        1. Installing via Smithery
        2. Installing Manually
      2. Claude Desktop Integration
        1. Usage
          1. Troubleshooting
            1. Server not showing up in Claude Desktop
          2. Documentation
            1. Development
              1. Contributing
                1. License

                  Related Resources

                  Related MCP Servers

                  • MyAIServ MCP Server

                    eagurin
                    -
                    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

                  • Awesome MCP FastAPI

                    MR-GREEN1337
                    -
                    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

                  • MCP Server for Replicate

                    tzafrir
                    -
                    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

                  • FastAPI SSE MCP Random

                    hk4crprasad
                    -
                    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

                  Appeared in Searches

                  New 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