Replicate MCP Server
by deepfates
Replicate MCP Server
A Model Context Protocol server implementation for Replicate. Run Replicate models through a simple tool-based interface.
Quickstart
- Install the server:
Copy
- Get your Replicate API token:
- Go to Replicate API tokens page
- Create a new token if you don't have one
- Copy the token for the next step
- Configure Claude Desktop:
- Open Claude Desktop Settings (<kbd>ā</kbd><kbd>,</kbd>)
- Select the "Developer" section in the sidebar
- Click "Edit Config" to open the configuration file
- Add the following configuration, replacing
your_token_here
with your actual Replicate API token:
Copy
- Start Claude Desktop. You should see a šØ hammer icon in the bottom right corner of new chat windows, indicating the tools are available.
(You can also use any other MCP client, such as Cursor, Cline, or Continue.)
Alternative Installation Methods
Install from source
Copy
Run with npx
Copy
Features
Models
- Search models using semantic search
- Browse models and collections
- Get detailed model information and versions
Predictions
- Create predictions with text or structured input
- Track prediction status
- Cancel running predictions
- List your recent predictions
Image Handling
- View generated images in your browser
- Manage image cache for better performance
Configuration
The server needs a Replicate API token to work. You can get one at Replicate.
There are two ways to provide the token:
1. In Claude Desktop Config (Recommended)
Add it to your Claude Desktop configuration as shown in the Quickstart section:
Copy
2. As Environment Variable
Alternatively, you can set it as an environment variable if you're using another MCP client:
Copy
Available Tools
Model Tools
search_models
: Find models using semantic searchlist_models
: Browse available modelsget_model
: Get details about a specific modellist_collections
: Browse model collectionsget_collection
: Get details about a specific collection
Prediction Tools
create_prediction
: Run a model with your inputsget_prediction
: Check a prediction's statuscancel_prediction
: Stop a running predictionlist_predictions
: See your recent predictions
Image Tools
view_image
: Open an image in your browserclear_image_cache
: Clean up cached imagesget_image_cache_stats
: Check cache usage
Troubleshooting
Server is running but tools aren't showing up
- Check that Claude Desktop is properly configured with the MCP server settings
- Ensure your Replicate API token is set correctly
- Try restarting both the server and Claude Desktop
- Check the server logs for any error messages
Tools are visible but not working
- Verify your Replicate API token is valid
- Check your internet connection
- Look for any error messages in the server output
Development
- Install dependencies:
Copy
- Start development server (with auto-reload):
Copy
- Check code style:
Copy
- Format code:
Copy
Requirements
- Node.js >= 18.0.0
- TypeScript >= 5.0.0
- Claude Desktop for using the tools
License
MIT
You must be authenticated.
Enables users to access and manage Replicate's AI models and predictions via the Model Context Protocol, offering tools for creating, canceling, and retrieving model predictions and parameters.