Replicate图像生成服务器

@gerred/mcp-server-replicate

0 Stars 416 次浏览 gerred 更新于 2026-08-23

一种FastMCP服务器实现，它通过Replicate API促进基于资源的AI模型推理访问，专注于图像生成，具有实时更新、Webhook集成和安全API密钥管理等功能。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

该服务需要配置环境变量：REPLICATE_API_TOKEN

服务介绍

MCP Server Replicate

一个针对Replicate API的FastMCP服务器实现，提供基于资源的AI模型推理访问，重点在于图像生成。

特性

🖼️ 基于资源的图像生成与管理
🔄 通过订阅实现实时更新
📝 模板驱动的参数配置
🔍 全面的模型发现与选择
🪝 Webhook集成以支持外部通知
🎨 质量和风格预设以获得最佳结果
📊 进度跟踪和状态监控
🔒 安全的API密钥管理

可用提示

该服务器为不同的任务提供了几种专门的提示：

文本到图像（主要）

我们测试最彻底且最健壮的提示。优化了从文本描述生成高质量图像的功能，包括：

详细的风格控制
质量预设（草稿、平衡、质量、极致）
尺寸和宽高比自定义
进度跟踪和实时更新

示例：

Create a photorealistic mountain landscape at sunset with snow-capped peaks, quality level: quality, style: photorealistic

其他提示

图像到图像：转换现有图像（即将推出）
模型选择：帮助您选择适合您任务的正确模型
参数帮助：理解和配置模型参数

前提条件

Python 3.11或更高版本
一个Replicate API密钥（在 https://replicate.com/account 获取）
UV 用于依赖管理

安装

通过Smithery安装

要通过Smithery自动为Claude Desktop安装MCP Server Replicate：

npx -y @smithery/cli install @gerred/mcp-server-replicate --client claude

手动安装

您可以直接从PyPI安装包：

# Using UV (recommended)
uv pip install mcp-server-replicate

# Using UVX for isolated environments
uvx install mcp-server-replicate

# Using pip
pip install mcp-server-replicate

Claude Desktop 集成

确保已安装最新版本的Claude Desktop
打开您的Claude Desktop配置：

# macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
code %APPDATA%\Claude\claude_desktop_config.json

使用以下选项之一添加服务器配置：

{
  "globalShortcut": "Shift+Alt+A",
  "mcpServers": {
    "replicate": {
      "command": "uv",
      "args": ["tool", "run", "mcp-server-replicate"],
      "env": {
        "REPLICATE_API_TOKEN": "APITOKEN"
      },
      "cwd": "$PATH_TO_REPO"
    }
  }
}

设置您的Replicate API密钥：

# Option 1: Set in your environment
export REPLICATE_API_TOKEN=your_api_key_here

# Option 2: Create a .env file in your home directory
echo "REPLICATE_API_TOKEN=your_api_key_here" > ~/.env

完全重启Claude Desktop

现在你应该能在Claude Desktop中看到🔨图标，这表明MCP服务器可用。

使用

一旦连接到Claude Desktop，你可以：

用自然语言生成图片：

Create a photorealistic mountain landscape at sunset with snow-capped peaks

浏览你的生成结果：
```
Show me my recent image generations
```
在生成结果中搜索：
```
Find my landscape generations
```

检查生成状态：

What's the status of my last generation?

故障排查

Claude Desktop 未显示服务器

检查 Claude Desktop 日志：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

验证您的配置：

确保 claude_desktop_config.json 中的路径是绝对路径
确认 UV 已安装并添加到 PATH 中
检查 Replicate API 密钥是否已设置

尝试重启 Claude Desktop

有关更详细的故障排除，请参阅我们的调试指南。

文档

开发

克隆仓库：

git clone https://github.com/gerred/mcp-server-replicate.git
cd mcp-server-replicate

安装开发依赖项：

uv pip install --system ".[dev]"

安装 pre-commit 钩子：

pre-commit install

运行测试：

pytest

贡献

我们欢迎贡献！请参阅我们的贡献指南获取详情。

许可证

本项目根据 MIT 许可证授权 - 详情请参见 LICENSE 文件。

查看源码项目主页