article
README
🚀 复制 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 令牌。
- 建议使用现代浏览器以获得最佳体验。
微信扫一扫