STARWARCLOUD STARWAR.AI
返回市场
悟空图像复制MCP服务器

悟空图像复制MCP服务器

作者：PierrunoYT2 星标更新：2025-09-17
安装使用来源：spider==github.com

项目介绍

Qwen Image Replicate MCP Server

这是一个使用阿里巴巴的Qwen Image模型通过Replicate平台提供图像生成能力的Model Context Protocol (MCP)服务器。

特性

Qwen Image是一个高级的文字转图像基础模型，擅长：

  • 在生成的图像中准确渲染复杂的文字布局
  • 精确的图像编辑能力
  • 根据详细的文本提示生成高质量的图像
  • 支持多种图像尺寸和纵横比
  • 先进的指导控制选项以微调结果

可用工具

generate_image

使用Qwen Image通过Replicate从文本提示生成高质量图像。

参数：

  • prompt（必需）：要生成的图像的文字描述（支持详细提示）
  • image_size（可选）：图像尺寸/纵横比 - 选择之一：1024x1024，720x1280，1280x720，768x1024，1024x768（默认：1024x768）
  • num_inference_steps（可选）：推理步骤数，数值越高质量越好但速度越慢（1-500，默认：50）
  • seed（可选）：用于可重复结果的随机种子（0-2147483647）
  • guidance_scale（可选）：CFG比例 - 如何紧密遵循提示（1-20，默认：4）
  • negative_prompt（可选）：指定图像中不应包含的内容（默认：""）

安装

前提条件

  1. Replicate API密钥：从Replicate获取您的API密钥

  2. Node.js：确保安装了Node.js（版本18或更高）

快速设置（推荐）

使用npx是最简单的方式，它会自动下载并运行最新版本：

对于Claude桌面应用

在您的Claude桌面配置文件中添加服务器：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "qwen-image": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/PierrunoYT/qwen-image-fal-mcp-server.git"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "your_replicate_token_here"
      }
    }
  }
}

对于Kilo Code MCP设置

在以下位置添加到您的MCP设置文件中： C:\Users\[username]\AppData\Roaming\Code\User\globalStorage\kilocode.kilo-code\settings\mcp_settings.json

{
  "mcpServers": {
    "qwen-image": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/PierrunoYT/qwen-image-fal-mcp-server.git"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "your_replicate_token_here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

npx配置的好处

✅ 通用访问：适用于任何安装了Node.js的机器 ✅ 无需本地安装：npx会自动下载和运行 ✅ 始终最新版本：从GitHub仓库拉取 ✅ 跨平台：兼容Windows、macOS和Linux ✅ 设置同步：在您使用的任何MCP客户端上都能工作

手动安装（替代方案）

如果您更喜欢本地安装：

  1. 克隆仓库

    git clone https://github.com/PierrunoYT/qwen-image-fal-mcp-server.git
cd qwen-image-fal-mcp-server

  2. 安装依赖项

    npm install

  3. 构建服务器

    npm run build

  4. 在配置中使用绝对路径

    {
  "mcpServers": {
    "qwen-image": {
      "command": "node",
      "args": ["/absolute/path/to/qwen-image-fal-mcp-server/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your_replicate_token_here"
      }
    }
  }
}

辅助脚本以获取绝对路径：

npm run get-path

使用示例

一旦配置完成，您可以通过您的MCP客户端使用该服务器：

基础图像生成

生成一幅夕阳下的宁静山景图，带有湖面倒影

复杂文字渲染

创建一张复古海报，上面有“欢迎来到AI艺术”字样，采用华丽字体和装饰艺术风格

指定图像尺寸

生成一幅纵向的城市未来景观图（1024x768）

高质量生成

生成一幅具有50个推理步骤和7.5指导比例的逼真肖像

高级参数

创建一幅详细的幻想风景图，负向提示为“模糊，低质量”，并使用种子12345以实现可重复性

API响应格式

服务器返回关于生成图像的详细信息：

✅ 成功使用Qwen Image生成了1张图像：

📝 **生成详情：**
• 提示：“夕阳下的宁静山景”
• 图像尺寸：1024x768
• 推理步骤：50
• 指导比例：4
• 使用的种子：1234567890
• 生成时间：4500ms

🖼️ **生成的图像（总计1张，已下载1张）：**
• 图像1：./images/qwen_image_mountain_landscape_0_2024-01-15T10-30-45.webp (https://replicate.delivery/...)

💾 图像已下载到本地的'images'目录。

开发

本地测试

# 直接测试服务器
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node build/index.js

监视模式

npm run watch

运行测试服务器

npm run test:server

健康检查

npm run health-check

调试工具

npm run inspector

环境变量

必需

  • REPLICATE_API_TOKEN：您的Replicate API密钥（用于图像生成）

可选

  • NODE_ENV：环境模式（development，production，test）- 默认：production
  • LOG_LEVEL：日志级别（error，warn，info，debug）- 默认：info
  • MAX_CONCURRENT_REQUESTS：最大并发请求数（1-10）- 默认：3
  • REQUEST_TIMEOUT：请求超时时间（毫秒）（30000-600000）- 默认：300000

故障排除

常见问题

  1. "REPLICATE_API_TOKEN环境变量是必需的"

    • 服务器将继续运行并显示这条有用的错误消息
    • 确保您的Replicate API密钥已在MCP配置中正确设置
    • 验证密钥有效且有足够的信用额度
    • 注意：当缺少API密钥时，服务器不再崩溃

  2. "服务器未出现在Claude中"

    • 如果使用npx配置，请确保已安装Node.js（v18+）
    • 对于手动安装，请检查绝对路径是否正确
    • 在更改配置后重启Claude Desktop
    • 验证JSON配置语法是否有效

  3. "生成失败"

    • 检查您的Replicate账户是否有足够的信用额度
    • 验证您的API密钥具有必要的权限
    • 尝试使用一个简单的提示来测试连接性
    • 检查图像尺寸和参数是否有效

  4. "找不到npx命令"

    • 确保Node.js已正确安装
    • 尝试运行node --version和npm --version以验证安装

服务器稳定性改进

✅ 强大的错误处理：即使没有API密钥，服务器也会继续运行 ✅ 优雅关闭：正确处理SIGINT和SIGTERM信号 ✅ 用户友好消息：清晰的错误消息附带设置说明 ✅ 不再崩溃：消除了导致连接中断的process.exit()调用 ✅ 本地图像存储：下载生成的图像以供离线访问

调试日志

服务器将调试信息输出到stderr，这有助于诊断问题：

  • 生成进度更新
  • 带有有用说明的错误消息
  • API调用详情
  • 优雅关闭通知

性能提示

  • 减少num_inference_steps以加快生成速度（尝试20-25）
  • 使用seed参数缓存结果以实现可重复性

定价

图像生成费用由Replicate的定价结构决定。查看Replicate定价以获取当前费率。

许可

该项目根据MIT许可协议发布 - 查看LICENSE文件以获取详细信息。

贡献

  1. 分叉仓库
  2. 创建功能分支
  3. 进行修改
  4. 如适用，添加测试
  5. 提交合并请求

支持

对于以下问题：

  • 此MCP服务器：在此仓库中打开问题
  • Replicate API：联系Replicate支持
  • Qwen Image模型：参考Replicate文档

更新记录

v1.1.0（最新）

  • 🚀 切换至Replicate：从fal.ai迁移到Replicate进行图像生成。
  • 🔧 更新依赖项：用replicate替换了@fal-ai/client。
  • ⚙️ 简化参数：移除了fal.ai特定的参数如sync_mode，acceleration，output_format等。
  • 📝 更新文档：所有文档现在反映了Replicate的使用情况。

v1.0.0

  • 🎨 Qwen Image集成：通过fal.ai完全实现了Qwen Image模型
  • 🔧 修复连接中断：移除了导致服务器崩溃的process.exit()调用
  • 🛡️ 改进错误处理：即使没有API密钥，服务器也会继续运行
  • 🌍 增加便携性：npx配置可在任何机器上工作
  • 📦 增强稳定性：优雅关闭处理器和空值安全检查
  • 💬 更好的用户体验：清晰的错误消息附带设置说明
  • 🔄 自动更新：npx会自动从GitHub拉取最新版本
  • 📁 本地图像存储：将生成的图像下载到本地目录
  • 🎯 高级参数：支持所有Qwen Image参数，包括LoRAs
  • ⚡ 性能优化：可配置加速级别
  • 🛡️ 安全特性：内置内容安全性检查

v0.1.1

  • 初始fal.ai集成
  • 基础图像生成功能

v0.1.0

  • 初始发布，带有占位符实现

额外资源