MCP服务器复制

Name: MCP服务器复制
Author: gerred

作者：gerred16 星标更新：2025-03-01

安装使用来源：spider==github.com

项目介绍

MCP Server Replicate

这是一个针对 Replicate API 的 FastMCP 服务器实现，提供基于资源的访问，专注于图像生成的 AI 模型推理。

功能

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

可用提示

该服务器提供了几种专门用于不同任务的提示：

文本到图像（主要）

我们经过最彻底测试且最健壮的提示。优化了从文本描述生成高质量图像的功能，包括：

详细的样式控制
质量预设（草稿、平衡、质量、极端）
尺寸和纵横比自定义
进度跟踪和实时更新

示例：

创建一个日落时分带有积雪山峰的真实感山脉景观，质量级别：质量，样式：真实感

其他提示

图像到图像：转换现有图像（即将推出）
模型选择：获取帮助以选择适合您任务的正确模型
参数帮助：理解并配置模型参数

先决条件

Python 3.11 或更高版本
Replicate API 密钥（在 https://replicate.com/account 获取）
UV 用于依赖项管理

安装

通过 Smithery 安装

要通过 Smithery 自动安装 MCP Server Replicate for Claude Desktop：

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

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

设置您的 Replicate API 密钥：

# 选项 1：在环境变量中设置
export REPLICATE_API_TOKEN=your_api_key_here

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

完全重启 Claude Desktop

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

使用方法

连接到 Claude Desktop 后，您可以：

使用自然语言生成图像：

创建一个日落时分带有积雪山峰的真实感山脉景观

浏览您的生成内容：
```
显示我最近的图像生成
```
搜索生成内容：
```
查找我的风景生成
```

检查生成状态：

我上一次生成的状态是什么？

故障排除

服务器未出现在 Claude Desktop 中

检查 Claude Desktop 日志：

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

验证您的配置：

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

尝试完全重启 Claude Desktop

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

文档

开发

克隆仓库：

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

安装开发依赖项：

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

安装 pre-commit 钩子：

pre-commit install

运行测试：

pytest

贡献

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

许可证

本项目采用 MIT 许可证 - 详情请参见 LICENSE 文件。