AI导哈

AI模型推理服务

MCP Server Replicate是一个基于Replicate API的FastMCP服务器实现，专注于提供资源化的AI模型推理服务，特别擅长图像生成。

  • by gerred
  • Python
  • 本地部署
  • 16 星标
  • 更新于
在 GitHub 查看 gerred/mcp-server-replicate

使用说明

MCP服务器复制

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

特性

  • 🖼️ 基于资源的图像生成和管理
  • 🔄 通过订阅进行实时更新
  • 📝 模板驱动参数配置
  • 🔍 全面的模型发现和选择
  • 🪝 外部通知的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)
  • 紫外线的 用于依赖关系管理

安装

通过Smithery安装

通过以下方式自动安装MCP Server Replicate for Claude Desktop 史密瑟里:

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
  1. 使用以下选项之一添加服务器配置：
{
  "globalShortcut": "Shift+Alt+A",
  "mcpServers": {
    "replicate": {
      "command": "uv",
      "args": ["tool", "run", "mcp-server-replicate"],
      "env": {
        "REPLICATE_API_TOKEN": "APITOKEN"
      },
      "cwd": "$PATH_TO_REPO"
    }
  }
}
  1. 设置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
  1. 完全重新启动克劳德桌面

现在你应该看到🔨 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. 检查克劳德桌面日志：
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
  1. 验证您的配置：
  • 确保路径正确 claude_desktop_config.json 是绝对的
  • 确保UV已安装并位于PATH中
  • 检查您的Replicate API密钥是否已设置
  1. 尝试重新启动Claude Desktop

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

文档

发展

  1. 克隆存储库：
git clone https://github.com/gerred/mcp-server-replicate.git
cd mcp-server-replicate
  1. 安装开发依赖项：
uv pip install --system ".[dev]"
  1. 安装预提交挂钩：
pre-commit install
  1. 运行测试：
pytest

贡献

我们欢迎捐款！请查看我们的 贡献指南 了解详情。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP