MCP 服务器

Flux ImageGen MCP Server

falahgs

开发者工具

访问服务器

README

Flux ImageGen MCP 服务器

一个专门用于图像生成和处理的模型上下文协议 (MCP) 服务器，由 Pollinations AI 提供支持。

开发者

作者: Falah.G.Salieh
版权所有: © 2025 保留所有权利

概述

ImageGen MCP 服务器是一个简化的服务器实现，通过模型上下文协议 (MCP) 提供强大的图像生成功能。该服务器专注于三个核心功能：

图像 URL 生成
直接图像生成
模型列表和管理

特性

🖼️ 图像生成: 从文本提示创建令人惊叹的图像
🎨 多种模型: 支持各种图像生成模型
🔧 灵活配置: 易于设置和自定义
🚀 高性能: 针对快速响应时间进行了优化
🔄 MCP 兼容: 完全符合模型上下文协议

安装

# 克隆仓库
git clone https://github.com/yourusername/flux-imagegen-mcp-server.git

# 安装依赖
npm install

配置

Claude Desktop 配置

要将此服务器与 Claude Desktop 一起使用，请更新您的配置文件，路径为： C:\Users\[YourUsername]\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcpollinations": {
      "command": "cmd",
      "args": [
        "/c",
        "node",
        "PATH_TO_YOUR_SERVER\\server.js"
      ],
      "tools": [
        "generateImageUrl",
        "generateImage",
        "listImageModels"
      ]
    }
  }
}

将 PATH_TO_YOUR_SERVER 替换为您的实际服务器路径。

可用工具

1. 生成图像 URL (`generateImageUrl`)

根据文本提示生成图像的 URL。

{
  "prompt": "A beautiful sunset over mountains",
  "model": "flux",  // optional, defaults to 'flux'
  "width": 1024,    // optional
  "height": 1024,   // optional
  "enhance": true,  // optional
  "safe": false     // optional
}

2. 生成图像 (`generateImage`)

直接从文本提示生成并保存图像。

{
  "prompt": "A serene lake reflecting mountains",
  "model": "flux",
  "width": 1024,
  "height": 1024,
  "enhance": true,
  "safe": false,
  "outputPath": "./output",
  "fileName": "mountain_lake",
  "format": "png"
}

3. 列出图像模型 (`listImageModels`)

返回可用图像生成模型的列表。

// 示例响应:
{
  "models": [
    {
      "id": "flux",
      "name": "Flux",
      "description": "Default image generation model"
    },
    // ... 其他模型
  ]
}

运行服务器

# 启动服务器
node server.js

环境要求

Node.js >= 16.0.0
NPM >= 7.0.0
兼容 Windows/Linux/MacOS

开发

要贡献或修改服务器：

Fork 仓库
创建您的功能分支
进行更改
提交 pull request

错误处理

服务器为常见问题提供详细的错误消息：

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": { /* Additional error details */ }
  }
}

示例

基本图像生成

// 生成图像 URL
const response = await generateImageUrl({
  prompt: "A futuristic city at night",
  model: "flux",
  width: 1024,
  height: 1024
});

// 生成并保存图像
const image = await generateImage({
  prompt: "A peaceful garden with butterflies",
  outputPath: "./images",
  fileName: "garden_scene"
});

下载图像示例

// 从 URL 下载图像
const downloadResult = await downloadImage({
  imageUrl: "https://example.com/image.jpg",
  fileName: "downloaded-image",
  format: "png"
});