Replicate MCP 服务器

一个为 Replicate 提供的 模型上下文协议 服务器实现。通过一个简单的基于工具的界面运行 Replicate 模型。

快速开始

1. 安装服务器：

npm install -g mcp-replicate

2. 获取你的 Replicate API 令牌：

   • 前往 Replicate API 令牌页面
   • 如果你还没有令牌，创建一个新的
   • 复制令牌以供下一步使用

3. 配置 Claude Desktop：

   • 打开 Claude Desktop 设置 (<kbd>⌘</kbd><kbd>,</kbd>)
   • 在侧边栏中选择 "Developer"（开发者）部分
   • 点击 "Edit Config"（编辑配置）以打开配置文件
   • 添加以下配置，将 your_token_here 替换为你实际的 Replicate API 令牌：

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

4. 启动 Claude Desktop。你应该在新聊天窗口的右下角看到一个 🔨 锤子图标，表示这些工具可用。

（你也可以使用任何其他 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 获取一个。

有两种方法可以提供令牌：

1. 在 Claude Desktop 配置中（推荐）

如快速入门部分所示，将其添加到你的 Claude Desktop 配置中：

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

2. 作为环境变量

或者，如果你使用其他 MCP 客户端，你可以将其设置为环境变量：

export REPLICATE_API_TOKEN=your_token_here

可用工具

模型工具

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

预测工具

• create_prediction: 使用你的输入运行模型
• get_prediction: 检查预测的状态
• cancel_prediction: 停止正在运行的预测
• list_predictions: 查看你最近的预测

图像工具

• view_image: 在浏览器中打开图像
• clear_image_cache: 清理缓存的图像
• get_image_cache_stats: 检查缓存使用情况

故障排除

服务器正在运行但工具未显示

1. 检查 Claude Desktop 是否已正确配置 MCP 服务器设置
2. 确保你的 Replicate API 令牌已正确设置
3. 尝试重新启动服务器和 Claude Desktop
4. 检查服务器日志中是否有任何错误消息

工具可见但无法工作

1. 验证你的 Replicate API 令牌是否有效
2. 检查你的互联网连接
3. 在服务器输出中查找任何错误消息

开发

1. 安装依赖项：

npm install

2. 启动开发服务器（具有自动重新加载）：

npm run dev

3. 检查代码风格：

npm run lint

4. 格式化代码：

npm run format

要求

• Node.js >= 18.0.0
• TypeScript >= 5.0.0
• Claude Desktop 用于使用这些工具

许可证

MIT