Replicate MCP Server 使用说明

项目简介

Replicate MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它允许你通过兼容 MCP 协议的客户端（如 Claude Desktop, Cursor, Cline, Continue 等）来使用 Replicate 平台上强大的 AI 模型。该服务器将 Replicate 的功能封装成一系列工具，使得你可以方便地在支持 MCP 的应用中调用 Replicate 的模型进行各种任务，例如文本生成、图像生成等。

主要功能点

模型发现与探索: 可以搜索、浏览 Replicate 上的模型和模型集合，并获取模型的详细信息。
模型推理 (Prediction) 管理: 支持创建、查询、取消模型推理任务，获取推理状态和结果。
图像处理: 提供查看生成图像的功能，并具备图像缓存管理以优化性能。
工具化接口: 通过一系列预定义的工具，将 Replicate 的各项能力以标准化的方式暴露给 MCP 客户端，方便集成和调用。

安装步骤

安装 Node.js: 确保你的系统已安装 Node.js (版本 >= 18.0.0) 和 npm 包管理器。
全局安装服务器: 打开终端，运行以下命令全局安装 'mcp-replicate'：
```
npm install -g mcp-replicate
```

服务器配置 (以 Claude Desktop 为例)

要让 MCP 客户端（例如 Claude Desktop）连接到 Replicate MCP Server，你需要配置客户端，指定服务器的启动命令和必要的环境变量。以下是 Claude Desktop 的配置示例，你需要将它添加到 Claude Desktop 的配置文件中。

打开 Claude Desktop 设置 (Cmd + ,)，选择 "Developer" 选项，点击 "Edit Config" 打开配置文件，添加或修改 'mcpServers' 部分，加入以下配置：

{
  "mcpServers": {
    "replicate": {  // 服务器名称，可以自定义
      "command": "mcp-replicate", // 启动服务器的命令，全局安装后可以直接使用 mcp-replicate
      "env": {
        "REPLICATE_API_TOKEN": "YOUR_REPLICATE_API_TOKEN"  // 必须替换为你在 Replicate 官网申请的 API Token
      }
    }
  }
}

配置参数说明:

'"replicate"': 服务器名称，用于在 Claude Desktop 中标识这个 Replicate MCP 服务器。你可以自定义这个名称。
'"command": "mcp-replicate"': 启动 Replicate MCP 服务器的命令。由于你已经全局安装了 'mcp-replicate'，所以可以直接使用这个命令。
'"env"': 环境变量配置。这里通过环境变量 'REPLICATE_API_TOKEN' 将你的 Replicate API Token 传递给服务器。
- '"REPLICATE_API_TOKEN": "YOUR_REPLICATE_API_TOKEN"': 请务必将 '"YOUR_REPLICATE_API_TOKEN"' 替换为你真实的 Replicate API Token。 你可以在 Replicate 官网获取你的 API Token。

基本使用方法

启动 MCP 客户端: 配置完成后，启动你的 MCP 客户端 (例如 Claude Desktop)。
使用工具: 如果配置正确，在 MCP 客户端中，你应该能看到一个锤子🔨图标，这表示 Replicate MCP Server 提供的工具已经可用。你可以通过客户端提供的界面或命令来调用这些工具，例如：
- 使用 'search_models' 工具搜索 Replicate 模型。
- 使用 'create_prediction' 工具运行模型进行推理。
- 使用 'list_predictions' 工具查看最近的推理任务。
- 使用 'view_image' 工具查看生成的图像。

具体工具的使用方式取决于你使用的 MCP 客户端的功能和界面。请参考你使用的 MCP 客户端的文档来了解如何调用和使用这些工具。

注意: 使用 Replicate 模型需要有效的 Replicate API Token，请确保你已在 Replicate 官网注册账号并获取 API Token，并将其正确配置到 MCP 服务器的环境变量中。

关键词