Aiimagemultistyle

MCP 图像生成器

一个使用 fal.ai 的 Stable Diffusion 模型进行图像生成和处理的模型上下文协议（MCP）服务。

功能

• 根据文本提示词生成高质量图像
• 支持多种动漫和艺术风格：
  • 吉卜力风格
  • 皮克斯风格
  • 宝可梦风格
  • 原神风格
  • 赛博朋克风格
  • 海贼王风格
  • 进击的巨人风格
  • 新海诚风格
  • 美少女战士风格
  • 新世纪福音战士风格
  • 迪士尼公主风格
  • 京都动画风格
  • 梦工厂动画风格
  • 漫威影业风格
  • DC 漫画风格
  • 可爱粉彩风格
  • 辛普森一家风格
  • 龙珠风格
  • 鬼灭之刃风格
  • 华纳兄弟动画风格
  • 黑暗奇幻风格
  • 以及更多日本动漫风格
• 多种图像尺寸选项：
  • 正方形（512x512）
  • 高清正方形（1024x1024）
  • 纵向 4:3（768x1024）
  • 纵向 16:9（576x1024）
  • 横向 4:3（1024x768）
  • 横向 16:9（1024x576）
• 单次请求生成多张图像（最多 4 张）
• 图像放大（分辨率增强 4 倍）
• 图像搜索和替换功能
• 内置 NSFW 内容检测

安装

1. 克隆代码库：

git clone [repository-url]
cd aiimagemultistyle

2. 安装依赖：

npm install

3. 配置环境变量： 创建一个 .env 文件，内容如下：

FALAI_API_KEY=your_fal_ai_key_here

用法

MCP 服务配置

要使用 MCP 图像生成器服务，请将其添加到 mcpServers 配置中：

{
  "mcpServers": {
    "image-generator": {
      "command": "npx",
      "args": ["-y", "aiimagemultistyle"]
    }
  }
}

你也可以指定其他配置选项：

{
  "mcpServers": {
    "image-generator": {
      "command": "npx",
      "args": [
        "-y",
        "aiimagemultistyle",
        "--mode=rest",
        "--port=9593",
        "--endpoint=/rest"
      ],
      "env": {
        "FALAI_API_KEY": "your_fal_ai_key_here"
      }
    }
  }
}

启动服务

服务可以以两种模式运行：

1. STDIO 模式（默认）：

npm start

2. REST 模式：

npm start -- --mode=rest --port=9593 --endpoint=/rest

API 参考

生成图像

请求格式：

{
  "name": "generate_image",
  "arguments": {
    "prompt": "A beautiful sunset over mountains",
    "style": "ghibli-style",
    "num_images": 1,
    "size": "square_hd"
  }
}

参数：

• prompt（必填）：要生成图像的文本描述
• style（可选）：图像风格（默认值："ghibli-style"）
  • 可用风格：完整列表请参见上方的“功能”部分
• num_images（可选）：要生成的图像数量（1-4，默认值：1）
• size（可选）：图像尺寸（默认值："square_hd"）
  • 可用尺寸："square"、"square_hd"、"portrait_4_3"、"portrait_16_9"、"landscape_4_3"、"landscape_16_9"

放大图像

请求格式：

{
  "name": "upscale_image",
  "arguments": {
    "image_url": "https://example.com/image.jpg"
  }
}

参数：

• image_url（必填）：要放大的图像 URL

搜索和替换

请求格式：

{
  "name": "search-and-replace",
  "arguments": {
    "image_url": "https://example.com/image.jpg",
    "mask_url": "https://example.com/mask.jpg",
    "prompt": "Description of the replacement"
  }
}

参数：

• image_url（必填）：要编辑的图像 URL
• mask_url（必填）：蒙版图像 URL（保留黑色区域，对白色区域进行修补）
• prompt（必填）：替换内容的描述

开发

• npm run build：构建项目
• npm run watch：开发用监视模式
• npm run inspector：运行 MCP 检查器

错误处理

服务会针对常见问题提供详细的错误消息：

• 缺少 API 密钥
• 提示词无效
• 风格或尺寸参数无效
• API 请求失败
• NSFW 内容检测

许可证

MIT