Replicate MCP Server

This project provides a Model Context Protocol server implementation for Replicate, enabling users to run Replicate models through a tool-based interface within MCP-compatible clients like Claude Desktop.

Quickstart

Install the server using npm install -g mcp-replicate, obtain a Replicate API token, and configure your MCP client (e.g., Claude Desktop) with the server details, including the token.

Alternative Installation Methods

Install from source by cloning the repository and running npm install, npm run build, and npm start. Alternatively, use npx mcp-replicate for a quick, one-time execution.

Features

The server offers features such as semantic model search, browsing models and collections, detailed model information, prediction creation and tracking, prediction cancellation, recent prediction listing, image viewing, and image cache management.

Configuration

Configure the Replicate API token either in the MCP client's configuration or as an environment variable (REPLICATE_API_TOKEN).

Troubleshooting

The README provides troubleshooting steps for common issues, such as tools not showing up or not working, emphasizing API token validity and server configuration.

Development

The README provides steps for local development, including installing dependencies, starting the development server, checking code style, and formatting code.

Requirements

The project requires Node.js >= 18.0.0, TypeScript >= 5.0.0, and Claude Desktop for using the tools.

License

MIT