MCP 服务器复制

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

特征

• 🖼️基于资源的图像生成和管理

• 🔄 通过订阅实时更新

• 📝 模板驱动的参数配置

• 🔍 全面的模型发现和选择

• 🪝 用于外部通知的 Webhook 集成

• 🎨 质量和样式预设，以获得最佳效果

• 📊 进度跟踪和状态监控

• 🔒 安全的 API 密钥管理

Related MCP server: Awesome MCP FastAPI

可用提示

服务器针对不同的任务提供了几个专门的提示：

文本转图像（主要）

我们最全面测试过、功能最强大的提示。针对从文本描述生成高质量图像进行了优化，具有以下功能：

• 详细的样式控制

• 质量预设（草稿、平衡、质量、极端）

• 尺寸和纵横比自定义

• 进度跟踪和实时更新

例子：

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

其他提示

• 图像到图像：转换现有图像（即将推出）

• 模型选择：获得帮助，为您的任务选择合适的模型

• 参数帮助：了解和配置模型参数

先决条件

• Python 3.11 或更高版本

• 复制 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 桌面集成

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. 设置您的复制 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 中

• 检查您的复制 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 install

4. 运行测试：

pytest

贡献

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

执照

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