mcp-server-replicate

🚀 MCP 服务器复制

Replicate API 的快速 MCP 服务器实现，提供基于资源的 AI 模型推理访问，专注于图像生成。它能以优化的处理流程，实现低延迟和高效率的图像生成服务，还兼容多种 AI 模型，满足不同用户的多样化需求。

🚀 快速开始

本项目可通过 PyPI 快速安装，安装完成后即可启动服务器开展图像生成工作。

✨ 主要特性

• 快速响应：优化的处理流程，确保低延迟和高效率。
• 多模型支持：兼容多种 AI 模型，满足不同需求。
• 自动化管理：自动处理资源分配和任务调度。
• 可扩展架构：支持横向扩展，适应高负载场景。

📦 安装指南

通过 PyPI 安装

pip install mcp-server-replicate

克隆仓库并安装依赖项

git clone https://github.com/gerred/mcp-server-replicate.git
cd mcp-server-replicate
uv pip install --system ".[dev]"

启动服务器

python -m mcp_server_replicate.start

💻 使用示例

基础用法

生成图像

• 自然语言输入

创建一张逼真的雪山日落景象，展示白雪覆盖的山峰。

• 基于模板生成

使用风景模板创建一副山脉景色图片。

浏览和管理

• 查看历史记录

显示我最近生成的所有图像

• 搜索特定内容

找到所有与“风景”相关的图像

• 检查状态

最近的图像生成进度如何？

📚 详细文档

• 实现计划
• 贡献指南
• API 参考
• 资源系统
• 模板系统

🔧 技术细节

故障排除

服务器未在 Claude 桌面中显示

1. 检查日志文件

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

2. 验证配置
   • 确保路径在 claude_desktop_config.json 中为绝对路径。
   • 确认 UV 已安装且在 PATH 环境变量中。
   • 检查 Replicate API 密钥是否设置。
3. 尝试重启 Claude 桌面

restart claude-desktop

开发步骤

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 文件。