复制 MCP 服务器

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

快速开始

1. 安装服务器：

npm install -g mcp-replicate

1. 获取您的 Replicate API 令牌：

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

2. 配置 Claude Desktop：

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

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

1. 启动 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

1. 启动开发服务器（带自动重载）：

npm run dev

1. 检查代码风格：

npm run lint

1. 格式化代码：

npm run format

要求

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

许可证

MIT