Flux Image MCP Server

此MCP服务器使用Replicate上的Flux Schnell模型提供图像生成功能。

安装

0. 全局安装MCP SDK：

npm install -g @modelcontextprotocol/sdk@latest

1. 将此仓库克隆到您的MCP服务器目录中：

cd ~/Documents/Cline/MCP
git clone https://github.com/yourusername/flux-img-mcp.git
cd flux-img-mcp
npm install

2. 构建服务器：

npm run build

3. 在您的MCP设置文件（全局或工作区）中添加服务器配置：

{
  "mcpServers": {
    "flux-img": {
      "command": "node",
      "args": ["/path/to/flux-img-mcp/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

配置

服务器需要以下环境变量：

• REPLICATE_API_TOKEN：您的Replicate API令牌。您可以在Replicate账户设置中获取此令牌。

使用

安装并配置后，服务器提供了以下工具：

generate_image

基于文本提示使用Flux Schnell模型生成图像。

参数：

• prompt（字符串，必需）：所需图像的文字描述

示例用法：

<use_mcp_tool>
<server_name>flux-img</server_name>
<tool_name>generate_image</tool_name>
<arguments>
{
  "prompt": "一座山上美丽的日落"
}
</arguments>
</use_mcp_tool>

该工具将返回包含以下内容的JSON响应：

• status：生成请求的状态
• output：生成的图像的URL（如果成功）
• error：任何错误消息（如果失败）

开发

要对服务器进行更改：

1. 修改src/index.ts中的源代码
2. 重新构建服务器：npm run build
3. 重启MCP服务器以使更改生效

错误处理

服务器包括全面的错误处理，涵盖：

• 缺失API令牌
• 无效参数
• API请求失败
• 网络问题

安全

• 切勿将Replicate API令牌提交到版本控制中
• 始终通过环境变量提供令牌
• 服务器在发出API请求之前会验证所有输入参数