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，用于访问浏览器中的调试工具。