图像生成服务

一个基于阿里云DashScope API的模型上下文协议服务器,提供图像生成、任务状态检查和图像下载功能。

  • by echozyr2001
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 echozyr2001/ali-flux-mcp

使用说明

阿里Flux MCP服务器

中文文档

用于阿里云DashScope API的模型上下文协议服务器

这是一个基于类型脚本的MCP服务器,提供与阿里云DashScope API交互的功能,用于生成图像并将其保存在本地。它通过提供以下内容展示了MCP的核心概念:

  • 使用阿里云DashScope API生成图像的工具
  • 用于检查任务状态的工具
  • 下载生成的图像并将其保存在本地的工具

特性

工具

  • generate_image -使用阿里云DashScope API生成图像

    • 将prompt作为必需参数
    • 可选参数:大小、种子、步长
    • 向DashScope API提交图像生成任务
  • check_task_status -检查图像生成任务状态

    • 将task_id作为必需参数
    • 返回图像生成任务的当前状态
  • download_image -下载生成的图像并将其保存在本地

    • 将task_id作为必需参数
    • 可选参数:自定义保存位置的save_path(必须是绝对路径)
    • 可选参数:base_dir用于解析相对路径(默认为WORK_dir环境变量)
    • 下载所有生成的图像并将其保存到指定目录

发展

先决条件

  • Node.js和npm
  • 阿里云DashScope API密钥

环境变量

  • DASHSCOPE_API_KEY:您的阿里云DashScope API密钥
  • SAVE_DIR:保存生成图像的目录(默认:~/桌面/通量图像)
  • MODEL_NAME:DashScope模型名称(默认:通量合并)
  • WORK_DIR:工作目录(默认:process.cwd())

设置

安装依赖项:

npm install

构建服务器:

npm run build

对于自动重建的开发:

npm run watch

安装

配置

要与Claude Desktop或其他MCP兼容客户端一起使用,请添加服务器配置:

在MacOS上: ~/Library/Application Support/Claude/claude_desktop_config.json 在Windows上: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ali-flux": {
      "command": "/path/to/ali-flux/build/index.js",
      "env": {
        "DASHSCOPE_API_KEY": "your-api-key-here",
        "SAVE_DIR": "/custom/save/path" // Optional
      }
    }
  }
}

调试

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

npm run inspector

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