使用说明

项目简介

MCP Server Replicate 是一个基于 Model Context Protocol (MCP) 的服务器实现，专注于为 Replicate API 提供资源驱动的访问，特别是图像生成模型。它允许用户通过 Claude Desktop 等 MCP 客户端调用 Replicate 的 AI 模型进行推理，并管理生成的图像资源。

主要功能点

图像生成与管理: 提供基于 Replicate API 的图像生成功能，并以资源的形式进行管理和访问。
实时更新订阅: 支持客户端订阅图像生成任务的状态更新，实时获取生成进度和结果。
模板驱动参数: 通过预定义的 Prompt 模板简化模型参数配置，方便用户快速启动生成任务。
模型发现与选择: 提供工具帮助用户发现和选择合适的 Replicate 模型。
Webhook 集成: 支持 Webhook 集成，用于外部事件通知和自动化流程。
质量与风格预设: 内置图像质量和风格预设，优化生成效果。
进度跟踪与监控: 提供生成任务的进度跟踪和状态监控功能。
API 密钥安全管理: 安全地管理 Replicate API 密钥。

安装步骤

环境准备: 确保已安装 Python 3.11 或更高版本，并拥有 Replicate API 密钥 (获取地址)。

安装 mcp-server-replicate: 推荐使用 'uv' 进行安装，也可以使用 'pip'。

uv pip install mcp-server-replicate

服务器配置

以下是在 MCP 客户端（如 Claude Desktop）中配置 MCP Server Replicate 的示例，配置信息为 JSON 格式：

{
  "server name": "replicate",
  "command": "uv",
  "args": ["tool", "run", "mcp-server-replicate"],
  "env": {
    "REPLICATE_API_TOKEN": "YOUR_REPLICATE_API_TOKEN"
  },
  "cwd": "$PATH_TO_REPO"
}

配置参数说明：

'server name': 服务器名称，用于在 MCP 客户端中标识和引用，可以自定义，例如 "replicate"。
'command': 启动 MCP Server Replicate 的命令，这里使用 'uv' 工具运行 'mcp-server-replicate'。
'args': 传递给 'command' 的参数，'["tool", "run", "mcp-server-replicate"]' 表示使用 'uv tool run' 运行 'mcp-server-replicate' 工具。
'env': 环境变量配置，'REPLICATE_API_TOKEN' 是必需的环境变量，请将 'YOUR_REPLICATE_API_TOKEN' 替换为你的 Replicate API 密钥。
'cwd': 可选参数，服务器的工作目录。如果你的仓库不在默认路径，可以设置为 MCP Server Replicate 仓库的根目录 '$PATH_TO_REPO'。

配置方法（以 Claude Desktop 为例）：

打开 Claude Desktop 的配置文件 'claude_desktop_config.json'。
在 'mcpServers' 字段下添加上述 JSON 配置，并将 'YOUR_REPLICATE_API_TOKEN' 替换为你的 Replicate API 密钥。
重启 Claude Desktop 以加载配置。

基本使用方法

配置完成后，在 MCP 客户端中即可使用以下指令与 MCP Server Replicate 交互：

生成图像: 使用自然语言描述你想要生成的图像，例如：'Create a photorealistic mountain landscape at sunset'。
查看最近的图像: 查询最近生成的图像列表，例如：'Show me my recent image generations'。
查询生成状态: 查询特定图像生成任务的状态，例如：'What's the status of my last generation?' 或 'Check status of generations://prediction_id'（将 'prediction_id' 替换为实际的 Prediction ID）。

更多详细用法和高级功能，请参考项目仓库的完整文档。

关键词