AI导哈

Flux AI图像生成服务器

一个基于TypeScript的MCP服务器，用于在Replicate上运行Flux AI图像生成模型，支持与MCP兼容应用集成和自定义图像参数。

  • by newtype-01
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 newtype-01/replicate-flux-mcp

使用说明

复制Flux MCP服务器

英语 | 中文

基于TypeScript的MCP服务器，用于在Replicate上运行Flux AI图像生成模型。

特性

  • 通过Replicate使用黑森林实验室/通量开发模型生成图像
  • 与任何兼容MCP的应用程序（Claude等）简单集成
  • 可定制的图像生成参数

快速开始

先决条件

安装

  1. 克隆此存储库
  2. 安装依赖项：
npm install
  1. 创建一个 .env 使用Replicate API令牌的文件：
REPLICATE_API_TOKEN=your_token_here
  1. 构建服务器：
npm run build

跑步

直接使用Node

直接运行服务器：

node build/index.js

使用npx

安装后，您可以通过npx运行服务器：

npx Replicate-Flux

使用Docker

构建Docker镜像：

docker build -t replicate-flux .

运行容器（传递API令牌）：

docker run -e REPLICATE_API_TOKEN=your_token_here replicate-flux

客户端配置

Claude和其他MCP客户

大多数MCP客户端都需要在其设置中进行配置。以下是示例：

使用本地安装

{
  "mcpServers": {
    "replicate-flux": {
      "command": "/path/to/replicate-flux/build/index.js"
    }
  }
}

使用npx

{
  "mcpServers": {
    "replicate-flux": {
      "command": "npx",
      "args": ["Replicate-Flux"]
    }
  }
}

使用Docker

{
  "mcpServers": {
    "replicate-flux": {
      "command": "docker",
      "args": ["run", "--rm", "-e", "REPLICATE_API_TOKEN=your_token_here", "replicate-flux"]
    }
  }
}

注意：如果您已经在 .env 文件或系统范围内，您可以省略 env 大多数配置中的字段。但是，对于Docker，您仍然需要通过容器传递环境变量。

环境变量

此项目需要以下环境变量：

  • REPLICATE_API_TOKEN -您的Replicate API令牌

您可以在 .env 文件，在您的系统环境中，或直接在MCP客户端配置中。

安全说明

  • 永远不要承诺你的 .env 文件或包含API版本控制密钥的任何文件
  • 这 .gitignore 文件已配置为排除 .env Git中的文件
  • 部署时，根据托管平台的说明安全地设置环境变量

发展

对于自动重建的开发：

npm run watch

调试

由于MCP服务器通过stdio进行通信，调试可能具有挑战性。我们建议使用 MCP检查员，可作为包脚本使用：

npm run inspector

检查器将提供一个URL，用于访问浏览器中的调试工具。

Replicate-Flux MCP 服务器

英语 | 中文

这是一个基于TypeScript的MCP服务器，用于在Replicate上运行Flux AI图像生成模型。

功能特点

  • 使用Replicate上的black-forest-labs/flux-dev模型生成图像
  • 与任何MCP兼容应用（如Claude等）简单集成
  • 可自定义的图像生成参数

快速开始

前提条件

安装

  1. 克隆此仓库
  2. 安装依赖:
npm install
  1. 创建一个包含Replicate API令牌的.env文件:
REPLICATE_API_TOKEN=你的令牌
  1. 构建服务器:
npm run build

运行方式

直接使用Node

直接运行服务器:

node build/index.js

使用npx

安装后，可以通过npx运行服务器:

npx Replicate-Flux

使用Docker

构建Docker镜像:

docker build -t replicate-flux .

运行容器（传入你的API令牌）:

docker run -e REPLICATE_API_TOKEN=你的令牌 replicate-flux

客户端配置

Claude和其他MCP客户端

大多数MCP客户端需要在其设置中进行配置。以下是一些例子：

使用本地安装

{
  "mcpServers": {
    "replicate-flux": {
      "command": "/path/to/replicate-flux/build/index.js"
    }
  }
}

使用npx

{
  "mcpServers": {
    "replicate-flux": {
      "command": "npx",
      "args": ["Replicate-Flux"]
    }
  }
}

使用Docker

{
  "mcpServers": {
    "replicate-flux": {
      "command": "docker",
      "args": ["run", "--rm", "-e", "REPLICATE_API_TOKEN=你的令牌", "replicate-flux"]
    }
  }
}

注意：如果你已经在.env文件或系统环境中配置了环境变量，在大多数配置中可以省略env字段。但对于Docker，你仍然需要通过容器传递环境变量。

环境变量

此项目需要以下环境变量：

  • REPLICATE_API_TOKEN - 你的Replicate API令牌

你可以在.env文件中设置、在系统环境中设置，或直接在MCP客户端配置中设置。

安全须知

  • 切勿将.env文件或任何包含API密钥的文件提交到版本控制系统
  • .gitignore文件已配置为从Git中排除.env文件
  • 部署时，根据你的托管平台的说明安全地设置环境变量

开发

用于开发的自动重建：

npm run watch

调试

由于MCP服务器通过标准输入输出通信，调试可能具有挑战性。我们推荐使用MCP检查员，可通过以下包脚本使用：

npm run inspector

Inspector将提供一个URL，让你在浏览器中访问调试工具。

相关 MCP