MCP Server Replicate

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

<a href="https://glama.ai/mcp/servers/r830bzsk7r"><img width="380" height="200" src="https://glama.ai/mcp/servers/r830bzsk7r/badge" alt="Server Replicate MCP server" /></a>

特性

• 🖼️ 基于资源的图像生成和管理
• 🔄 通过订阅进行实时更新
• 📝 模板驱动的参数配置
• 🔍 全面的模型发现和选择
• 🪝 用于外部通知的 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 安装该软件包：

# 使用 UV (推荐)
uv pip install mcp-server-replicate

# 使用 UVX 进行隔离环境
uvx install mcp-server-replicate

# 使用 pip
pip install mcp-server-replicate

Claude Desktop 集成

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

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

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

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

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

4. 设置您的 Replicate API 密钥：

# 选项 1：在您的环境中设置
export REPLICATE_API_TOKEN=your_api_key_here

# 选项 2：在您的主目录中创建一个 .env 文件
echo "REPLICATE_API_TOKEN=your_api_key_here" > ~/.env

5. 完全重启 Claude Desktop

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

用法

连接到 Claude Desktop 后，您可以：

1. 使用自然语言生成图像：

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

2. 浏览您的生成：

   Show me my recent image generations
   

3. 搜索生成：

   Find my landscape generations
   

4. 检查生成状态：

   What's the status of my last generation?
   

故障排除

服务器未在 Claude Desktop 中显示

1. 检查 Claude Desktop 日志：

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

2. 验证您的配置：

• 确保 claude_desktop_config.json 中的路径是绝对路径
• 确保 UV 已安装并在您的 PATH 中
• 检查您的 Replicate API 密钥是否已设置

3. 尝试重启 Claude Desktop

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

文档

• 实施计划
• 贡献指南
• API 参考
• 资源系统
• 模板系统

开发

1. 克隆存储库：

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

2. 安装开发依赖项：

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

3. 安装 pre-commit 钩子：

pre-commit install

4. 运行测试：

pytest

贡献

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

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。