项目介绍
复制MCP服务器
这是一个用于Replicate的模型上下文协议服务器实现。通过简单的工具界面运行Replicate模型。
不再积极开发
此仓库是针对Replicate的MCP工具实验。该公司现在提供了一个官方的MCP服务器。此仓库会保留下来供那些发现它有用或想要分叉的人使用，但不再积极开发，也不会处理问题。可能会合并贡献，但不保证。自行承担风险享受使用。
快速开始
- 安装服务器：
npm install -g mcp-replicate
-
获取您的Replicate API令牌：
- 前往Replicate API令牌页面
- 如果您还没有令牌，请创建一个新的
- 复制令牌以备下一步使用
-
配置Claude Desktop：
- 打开Claude Desktop设置（<kbd>⌘</kbd><kbd>,</kbd>）
- 在侧边栏中选择“开发者”部分
- 点击“编辑配置”以打开配置文件
- 添加以下配置，将
your_token_here替换为您实际的Replicate API令牌：
{
"mcpServers": {
"replicate": {
"command": "mcp-replicate",
"env": {
"REPLICATE_API_TOKEN": "your_token_here"
}
}
}
}
- 启动Claude Desktop。您应该会在新聊天窗口右下角看到一个🔨锤子图标，表示工具可用。
（您也可以使用任何其他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获取一个。
有两种方式提供令牌：
1. 在Claude Desktop配置中（推荐）
按照快速开始部分所示添加到您的Claude Desktop配置中：
{
"mcpServers": {
"replicate": {
"command": "mcp-replicate",
"env": {
"REPLICATE_API_TOKEN": "your_token_here"
}
}
}
}
2. 作为环境变量
如果您使用的是另一个MCP客户端，可以将其设置为环境变量：
export REPLICATE_API_TOKEN=your_token_here
可用工具
模型工具
search_models: 使用语义搜索查找模型list_models: 浏览可用模型get_model: 获取特定模型的详细信息list_collections: 浏览模型集合get_collection: 获取特定集合的详细信息
预测工具
create_prediction: 运行带有您输入的模型create_and_poll_prediction: 运行带有您输入的模型并等待其完成get_prediction: 检查预测的状态cancel_prediction: 停止正在运行的预测list_predictions: 查看最近的预测
图像工具
view_image: 在浏览器中打开图像clear_image_cache: 清除缓存的图像get_image_cache_stats: 检查缓存使用情况
故障排除
服务器正在运行但工具没有显示
- 检查Claude Desktop是否正确配置了MCP服务器设置
- 确保您的Replicate API令牌设置正确
- 尝试重新启动服务器和Claude Desktop
- 检查服务器日志中的错误消息
工具可见但无法使用
- 验证您的Replicate API令牌有效
- 检查您的互联网连接
- 查看服务器输出中的任何错误消息
开发
- 安装依赖项：
npm install
- 启动开发服务器（自动重载）：
npm run dev
- 检查代码风格：
npm run lint
- 格式化代码：
npm run format
要求
- Node.js >= 18.0.0
- TypeScript >= 5.0.0
- Claude Desktop 用于使用工具
许可证
MIT