🚀 复制 MCP 服务器
本项目是为 Replicate 实现的 Model Context Protocol (MCP) 服务器，借助简单的基于工具的界面，可轻松运行 Replicate 模型。
🚀 快速开始
安装服务器
npm install -g mcp-replicate
获取 Replicate API 令牌
- 前往 Replicate API 令牌页面。
- 若没有令牌，可创建新令牌。
- 复制令牌，用于后续步骤。
配置 Claude 桌面端
- 打开 Claude 桌面设置（⌘,）。
- 在侧边栏选择“开发者”部分。
- 点击“编辑配置”打开配置文件。
- 添加以下配置，将
your_token_here替换为实际的 Replicate API 令牌：
{
"mcpServers": {
"replicate": {
"command": "mcp-replicate",
"env": {
"REPLICATE_API_TOKEN": "your_token_here"
}
}
}
}
启动 Claude 桌面端
启动后，在新聊天窗口的右下角会看到一个 🔨 锤子图标，表明工具已可用。
提示：你也可以使用其他 MCP 客户端，如 Cursor、Cline 或 Continue。
📦 安装指南
从源代码安装
git clone https://github.com/deepfates/mcp-replicate
cd mcp-replicate
npm install
npm run build
npm start
使用 npx 运行
npx mcp-replicate
✨ 主要特性
模型
- 支持使用语义搜索查找模型。
- 可浏览可用模型和集合。
- 能获取特定模型的详细信息和版本。
预测
- 可使用文本或结构化输入创建预测。
- 能跟踪预测状态。
- 可取消正在运行的预测。
- 可列出最近的预测记录。
图像处理
- 能在浏览器中查看生成的图像。
- 可管理图像缓存以提升性能。
📚 详细文档
配置
服务器正常工作需要 Replicate API 令牌，你可在 Replicate 获取。提供令牌有以下两种方式：
在 Claude 桌面端配置（推荐）
按快速开始部分的步骤，将其添加到 Claude 桌面端配置中：
{
"mcpServers": {
"replicate": {
"command": "mcp-replicate",
"env": {
"REPLICATE_API_TOKEN": "your_token_here"
}
}
}
}
作为环境变量
若使用其他 MCP 客户端，可将其设置为环境变量：
export REPLICATE_API_TOKEN=your_token_here
可用工具
模型工具
search_models：使用语义搜索查找模型。list_models：浏览可用模型。get_model：获取特定模型的详细信息。list_collections：浏览模型集合。get_collection：获取特定集合的详细信息。
预测工具
create_prediction：使用输入创建预测。get_prediction_status：获取预测的状态。cancel_prediction：取消正在运行的预测。list_predictions：列出最近的预测记录。
🔧 技术细节
故障排除
若遇到问题，可检查以下内容：
- 确保已正确设置 REPLICATE_API_TOKEN。
- 确保互联网连接正常，以便与 Replicate 服务通信。
- 查看控制台输出以获取更多错误信息。
开发
若要为该项目做出贡献或进行自定义开发，请参考 GitHub 仓库 中的文档和指南。
要求
- 系统必须安装 Node.js 和 npm。
- 需有有效的 Replicate API 令牌。
- 建议使用现代浏览器以获得最佳体验。