模型协议服务器

一个用于Replicate的模型上下文协议服务器实现,通过简单的工具界面运行Replicate模型。

  • by deepfates
  • TypeScript
  • 本地部署
  • 94 星标
  • 更新于
在 GitHub 查看 deepfates/mcp-replicate

使用说明

复制MCP服务器

A. 模型上下文协议 为Replicate实现服务器端。通过一个基于工具的简单界面运行Replicate模型。

未在积极开发中

这个仓库是用于Replicate的MCP(可能是指某种配置或管理工具,但具体需根据上下文确定,此处保留原英文缩写)工具的一次实验。该公司现在提供了一种 官方MCP服务器这个仓库将继续存在,供那些发现它有用或想要对其进行分支开发的人使用,但它不再进行积极开发,也不会处理相关问题。可能会接受贡献,但不作保证。请自行承担风险使用。

快速入门

  1. 安装服务器:
npm install -g mcp-replicate
  1. 获取您的Replicate API令牌:

    • 首选 复制API令牌页面
    • 如果你还没有令牌,请创建一个新的
    • 复制令牌以进行下一步操作
  2. 配置Claude桌面版:

    • 打开Claude桌面设置(⌘,)
    • 在侧边栏中选择“开发者”部分
    • 点击“编辑配置”以打开配置文件
    • 添加以下配置,替换 your_token_here 使用您实际的Replicate API令牌:
{
  "mcpServers": {
    "replicate": {
      "command": "mcp-replicate",
      "env": {
        "REPLICATE_API_TOKEN": "your_token_here"
      }
    }
  }
}
  1. 启动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令牌才能工作。您可以在 复制。

提供令牌有两种方式:

1. 在Claude桌面配置中(推荐)

按照快速入门部分所示,将其添加到您的Claude桌面配置中:

{
  "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检查缓存使用情况

故障排除

服务器正在运行,但工具没有显示

  1. 检查Claude Desktop是否已正确配置为与MCP服务器设置相匹配
  2. 确保您的Replicate API令牌设置正确
  3. 尝试重启服务器和Claude桌面程序
  4. 检查服务器日志中的任何错误信息

工具可见但无法使用

  1. 验证您的Replicate API令牌是否有效
  2. 检查您的网络连接
  3. 查看服务器输出中的任何错误信息

发展

  1. 安装依赖项:
npm install
  1. 启动开发服务器(带自动重载功能):
npm run dev
  1. 检查代码风格:
npm run lint
  1. 格式代码:
npm run format

要求

  • Node.js 版本 >= 18.0.0
  • TypeScript >= 5.0.0
  • Claude 桌面版 用于使用工具

许可证

麻省理工学院(MIT)