MCP 服务器复制
Replicate API 的 FastMCP 服务器实现，提供基于资源的 AI 模型推理访问，重点是图像生成。
特征
- 🖼️基于资源的图像生成和管理
- 🔄 通过订阅实时更新
- 📝 模板驱动的参数配置
- 🔍 全面的模型发现和选择
- 🪝 用于外部通知的 Webhook 集成
- 🎨 质量和样式预设，以获得最佳效果
- 📊 进度跟踪和状态监控
- 🔒 安全的 API 密钥管理
可用提示
服务器针对不同的任务提供了几个专门的提示：
文本转图像（主要）
我们最全面测试过、功能最强大的提示。针对从文本描述生成高质量图像进行了优化，具有以下功能：
- 详细的样式控制
- 质量预设（草稿、平衡、质量、极端）
- 尺寸和纵横比自定义
- 进度跟踪和实时更新
例子：
Create a photorealistic mountain landscape at sunset with snow-capped peaks, quality level: quality, style: photorealistic
其他提示
- 图像到图像：转换现有图像（即将推出）
- 模型选择：获得帮助，为您的任务选择合适的模型
- 参数帮助：了解和配置模型参数
先决条件
安装
通过 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]"
- 安装预提交钩子：
- 运行测试：
贡献
欢迎大家贡献！详情请参阅我们的贡献指南。
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。