Replicate

🚀 复制 MCP 服务器

本项目是为 Replicate 实现的 Model Context Protocol (MCP) 服务器，借助简单的基于工具的界面，可轻松运行 Replicate 模型。

🚀 快速开始

安装服务器

npm install -g mcp-replicate

获取 Replicate API 令牌

• 前往 Replicate API 令牌页面。
• 若没有令牌，可创建新令牌。
• 复制令牌，用于后续步骤。

配置 Claude 桌面端

• 打开 Claude 桌面设置（⌘,）。
• 在侧边栏选择“开发者”部分。
• 点击“编辑配置”打开配置文件。
• 添加以下配置，将 your_token_here 替换为实际的 Replicate API 令牌：

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

启动 Claude 桌面端

启动后，在新聊天窗口的右下角会看到一个 🔨 锤子图标，表明工具已可用。

提示：你也可以使用其他 MCP 客户端，如 Cursor、Cline 或 Continue。

📦 安装指南

从源代码安装

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

使用 npx 运行

npx mcp-replicate

✨ 主要特性

模型

• 支持使用语义搜索查找模型。
• 可浏览可用模型和集合。
• 能获取特定模型的详细信息和版本。

预测

• 可使用文本或结构化输入创建预测。
• 能跟踪预测状态。
• 可取消正在运行的预测。
• 可列出最近的预测记录。

图像处理

• 能在浏览器中查看生成的图像。
• 可管理图像缓存以提升性能。

📚 详细文档

配置

服务器正常工作需要 Replicate API 令牌，你可在 Replicate 获取。提供令牌有以下两种方式：

在 Claude 桌面端配置（推荐）

按快速开始部分的步骤，将其添加到 Claude 桌面端配置中：

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

作为环境变量

若使用其他 MCP 客户端，可将其设置为环境变量：

export REPLICATE_API_TOKEN=your_token_here

可用工具

模型工具

• search_models：使用语义搜索查找模型。
• list_models：浏览可用模型。
• get_model：获取特定模型的详细信息。
• list_collections：浏览模型集合。
• get_collection：获取特定集合的详细信息。

预测工具

• create_prediction：使用输入创建预测。
• get_prediction_status：获取预测的状态。
• cancel_prediction：取消正在运行的预测。
• list_predictions：列出最近的预测记录。

🔧 技术细节

故障排除

若遇到问题，可检查以下内容：

1. 确保已正确设置 REPLICATE_API_TOKEN。
2. 确保互联网连接正常，以便与 Replicate 服务通信。
3. 查看控制台输出以获取更多错误信息。

开发

若要为该项目做出贡献或进行自定义开发，请参考 GitHub 仓库 中的文档和指南。

要求

• 系统必须安装 Node.js 和 npm。
• 需有有效的 Replicate API 令牌。
• 建议使用现代浏览器以获得最佳体验。