local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Serves as a FastMCP server implementation for the Replicate API, providing resource-based access to AI model inference with a focus on image generation.

MCP 服务器复制

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 或更高版本
复制 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 桌面集成

确保您安装了最新版本的 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"
    }
  }
}

设置您的复制 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 中
检查您的复制 API 密钥是否已设置

尝试重启 Claude Desktop

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

文档

发展

克隆存储库：

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

安装开发依赖项：

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

安装预提交钩子：

pre-commit install

运行测试：

pytest

贡献

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

执照

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

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

View all tools

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

Related Resources

Reddit Discussion about this server