MCP Server Replicate

MCP Server Replicate

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

功能

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

可用提示词

该服务针对不同任务提供了多种专用提示词：

文本转图像（主要提示词）

这是我们经过最全面测试、最可靠的提示词。它针对根据文本描述生成高质量图像进行了优化，具备以下功能：

• 详细的风格控制
• 质量预设（draft、balanced、quality、extreme）
• 尺寸和宽高比自定义
• 进度跟踪与实时更新

示例：

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 集成

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 密钥：

# 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

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 文件。