🚀 复制 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 令牌。
• 建议使用现代浏览器以获得最佳体验。