Skip to content
Back to search

mcp-replicate

Model Context Protocol server for Replicate's API

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/deepfates--mcp-replicate/badge.svg)](/listings/deepfates--mcp-replicate)

HTML

<a href="/listings/deepfates--mcp-replicate"><img src="/api/listings/deepfates--mcp-replicate/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Install the server:

npm install -g mcp-replicate

2. Get your Replicate API token:

- Go to [Replicate API tokens page](https://replicate.com/account/api-tokens) - Create a new token if you don't have one - Copy the token for the next step

3. 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:

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

4. 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.)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 188 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Replicate MCP Server
  2. A [Model Context Protocol](https://github.com/mcp-sdk/mcp) server implementation for Replicate. Run Replicate models through a simple tool-based interface.
  3. ## NOT IN ACTIVE DEVELOPMENT
  4. This repo was an experiment in MCP tooling for Replicate. The company now offers an [official MCP server](https://replicate.com/docs/reference/mcp). This repo will stay up for those who find it useful or want to fork it, but it's not in active development and issues won't be addressed. Contributions might be folded in but no promises. Enjoy at your own risk.
  5. ## Quickstart
  6. 1. Install the server:
  7. ```bash
  8. npm install -g mcp-replicate
  9. ```
  10. 2. Get your Replicate API token:
  11. - Go to [Replicate API tokens page](https://replicate.com/account/api-tokens)
  12. - Create a new token if you don't have one
  13. - Copy the token for the next step
  14. 3. Configure Claude Desktop:
  15. - Open Claude Desktop Settings (<kbd>⌘</kbd><kbd>,</kbd>)
  16. - Select the "Developer" section in the sidebar
  17. - Click "Edit Config" to open the configuration file
  18. - Add the following configuration, replacing `your_token_here` with your actual Replicate API token:
  19. ```json
  20. {
  21. "mcpServers": {
  22. "replicate": {
  23. "command": "mcp-replicate",
  24. "env": {
  25. "REPLICATE_API_TOKEN": "your_token_here"
  26. }
  27. }
  28. }
  29. }
  30. ```
  31. 4. Start Claude Desktop. You should see a 🔨 hammer icon in the bottom right corner of new chat windows, indicating the tools are available.
  32. (You can also use any other MCP client, such as Cursor, Cline, or Continue.)
  33. ## Alternative Installation Methods
  34. ### Install from source
  35. ```bash
  36. git clone https://github.com/deepfates/mcp-replicate
  37. cd mcp-replicate
  38. npm install
  39. npm run build
  40. npm start
  41. ```
  42. ### Run with npx
  43. ```bash
  44. npx mcp-replicate
  45. ```
  46. ## Features
  47. ### Models
  48. - Search models using semantic search
  49. - Browse models and collections
  50. - Get detailed model information and versions
  51. ### Predictions
  52. - Create predictions with text or structured input
  53. - Track prediction status
  54. - Cancel running predictions
  55. - List your recent predictions
  56. ### Image Handling
  57. - View generated images in your browser
  58. - Manage image cache for better performance
  59. ## Configuration
  60. The server needs a Replicate API token to work. You can get one at [Replicate](https://replicate.com/account/api-tokens).
  61. There are two ways to provide the token:
  62. ### 1. In Claude Desktop Config (Recommended)
  63. Add it to your Claude Desktop configuration as shown in the Quickstart section:
  64. ```json
  65. {
  66. "mcpServers": {
  67. "replicate": {
  68. "command": "mcp-replicate",
  69. "env": {
  70. "REPLICATE_API_TOKEN": "your_token_here"
  71. }
  72. }
  73. }
  74. }
  75. ```
  76. ### 2. As Environment Variable
  77. Alternatively, you can set it as an environment variable if you're using another MCP client:
  78. ```bash
  79. export REPLICATE_API_TOKEN=your_token_here
  80. ```
  81. ## Available Tools
  82. ### Model Tools
  83. - `search_models`: Find models using semantic search
  84. - `list_models`: Browse available models
  85. - `get_model`: Get details about a specific model
  86. - `list_collections`: Browse model collections
  87. - `get_collection`: Get details about a specific collection
  88. ### Prediction Tools
  89. - `create_prediction`: Run a model with your inputs
  90. - `create_and_poll_prediction`: Run a model with your inputs and wait until it's completed
  91. - `get_prediction`: Check a prediction's status
  92. - `cancel_prediction`: Stop a running prediction
  93. - `list_predictions`: See your recent predictions
  94. ### Image Tools
  95. - `view_image`: Open an image in your browser
  96. - `clear_image_cache`: Clean up cached images
  97. - `get_image_cache_stats`: Check cache usage
  98. ## Troubleshooting
  99. ### Server is running but tools aren't showing up
  100. 1. Check that Claude Desktop is properly configured with the MCP server settings
  101. 2. Ensure your Replicate API token is set correctly
  102. 3. Try restarting both the server and Claude Desktop
  103. 4. Check the server logs for any error messages
  104. ### Tools are visible but not working
  105. 1. Verify your Replicate API token is valid
  106. 2. Check your internet connection
  107. 3. Look for any error messages in the server output
  108. ## Development
  109. 1. Install dependencies:
  110. ```bash
  111. npm install
  112. ```
  113. 2. Start development server (with auto-reload):
  114. ```bash
  115. npm run dev
  116. ```
  117. 3. Check code style:
  118. ```bash
  119. npm run lint
  120. ```
  121. 4. Format code:
  122. ```bash
  123. npm run format
  124. ```
  125. ## Requirements
  126. - Node.js >= 18.0.0
  127. - TypeScript >= 5.0.0
  128. - [Claude Desktop](https://claude.ai/download) for using the tools
  129. ## License
  130. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.