Ali-Flux MCP Server

Ali-Flux MCP Server

中文文档

用于 Alibaba Cloud DashScope API 的模型上下文协议服务

这是一个基于 TypeScript 的 MCP 服务，提供与 Alibaba Cloud DashScope API 交互、生成图像并将其保存到本地的功能。它通过提供以下功能展示了 MCP 的核心概念：

• 使用 Alibaba Cloud DashScope API 生成图像的工具
• 检查任务状态的工具
• 下载生成的图像并将其保存到本地的工具

功能

工具

• generate_image - 使用 Alibaba Cloud DashScope API 生成图像

  • 必需参数为提示词
  • 可选参数：size、seed、steps
  • 向 DashScope API 提交图像生成任务

• check_task_status - 检查图像生成任务状态

  • 必需参数为 task_id
  • 返回图像生成任务的当前状态

• download_image - 下载生成的图像并将其保存到本地

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

开发

先决条件

• Node.js 和 npm
• Alibaba Cloud DashScope API 密钥

环境变量

• DASHSCOPE_API_KEY：你的 Alibaba Cloud DashScope API 密钥
• SAVE_DIR：生成图像的保存目录（默认：~/Desktop/flux-images）
• MODEL_NAME：DashScope 模型名称（默认：flux-merged）
• 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 Inspector，它可作为包脚本使用：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。