ali-flux-mcp

🚀 阿里云DashScope API的Model Context Protocol（MCP）服务器

这是一个基于TypeScript的MCP服务器，可与阿里云DashScope API进行交互，实现图像生成与本地保存功能。该服务器对核心MCP概念进行了演示，具备以下实用工具：

• 借助阿里云DashScope API生成图像。
• 检查图像生成任务的状态。
• 下载生成的图像并保存至本地磁盘。

🚀 快速开始

此服务器是基于TypeScript构建的MCP服务器，用于和阿里云DashScope API交互，实现图像生成和本地保存功能。它能帮助你利用阿里云DashScope API完成图像生成任务，并将生成的图像保存到本地。

✨ 主要特性

工具

• generate_image：使用阿里云DashScope API生成图像。
  • 必填参数：提示词（prompt）。
  • 可选参数：大小（size）、随机种子（seed）、步骤（steps）。
  • 功能：提交图像生成任务到DashScope API。
• check_task_status：检查图像生成任务的状态。
  • 必填参数：任务ID（task_id）。
  • 功能：返回当前图像生成任务的状态。
• download_image：下载生成的图像并保存到本地磁盘。
  • 必填参数：任务ID（task_id）。
  • 可选参数：自定义保存路径（save_path，必须是绝对路径）。
  • 可选参数：用于解析相对路径的基础目录（base_dir，默认为WORK_DIR环境变量）。
  • 功能：将所有生成的图像下载并保存到指定目录。

📦 安装指南

开发准备

先决条件

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

环境变量

• DASHSCOPE_API_KEY：您的阿里云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" // 可选
      }
    }
  }
}

调试

由于MCP服务器通过stdio通信，调试可能具有挑战性。我们推荐使用MCP Inspector，它作为一个包脚本提供：

npm run inspector

Inspector将提供一个URL，用于在浏览器中访问调试工具。