mcp-replicate

Replicate MCP Server exposes a tool-based interface to interact with Replicate models via the MCP protocol. It provides model discovery and browsing, model detail views, prediction creation and tracking, and image handling for outputs. You can access these capabilities through any MCP-compatible client (such as Claude Desktop, Cursor, Cline, or Continue) by pointing the client to this server configuration and supplying your Replicate API token. The server handles authentication with Replicate and exposes tools like search_models, list_models, get_model, list_collections, get_collection, create_prediction, create_and_poll_prediction, get_prediction, cancel_prediction, and view_image, among others, enabling end-to-end model usage from your MCP client. When used with Claude Desktop, you’ll see a hammer icon indicating tools are available in new chats, streamlining model-based interactions.

To get started, configure the MCP server in your client with the provided replicate entry and token in the environment. You can then browse models, run predictions with structured inputs or text, monitor progress, and view generated images. The server supports token-based authentication via the REPLICATE_API_TOKEN environment variable, and the token can be supplied directly in Claude Desktop’s config or as a standard environment variable when using other clients.

If you already have a Replicate API token, simply supply it in the configuration to enable seamless model calls. The tools are organized into Model Tools, Prediction Tools, and Image Tools, allowing you to perform semantic searches, create and poll predictions, and manage generated images through the MCP layer.

Prerequisites:

• Node.js v18+ and npm (as required by the server)
• Internet access to fetch dependencies from npm
• A Replicate API token (for authenticating with Replicate)

Install from source (alternative method):

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

Quick start (global install):

npm install -g mcp-replicate

Then provide your Replicate API token in the client configuration or as an environment variable:

export REPLICATE_API_TOKEN=your_token_here

Or run directly with npx:

npx mcp-replicate

Configuration for Claude Desktop (example):

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

Tips and common issues:

• Ensure your Replicate API token is valid and has the necessary permissions for the models you intend to access.
• If tools do not appear in Claude Desktop, verify the MCP server configuration in Claude and restart the application.
• When using environment variables, you can either set them in your client’s config (recommended for Claude) or export them in your shell before launching the server.
• The server requires network access to Replicate; ensure your firewall or network policies allow outbound connections.
• This project notes that it is not in active development; consider using the official MCP server if you need longer-term support.
• For development, you can run in dev mode if available (check npm scripts like npm run dev) and lint/format via the corresponding npm scripts.