mcpField
A
Ali-Flux MCP Server

Ali-Flux MCP Server

Local
github.com/echozyr2001Media & Design0Updated 79w ago
Repository

About Ali-Flux MCP Server

Ali-Flux MCP Server connects MCP clients to Alibaba Cloud DashScope image generation. It supports task tracking and saving generated images locally.

Key features

  1. 01Generate images with DashScope
  2. 02Set size, seed, and steps
  3. 03Check generation task status
  4. 04Download images to local paths

Use cases

  1. 01Generate images from text prompts
  2. 02Track a submitted generation task
  3. 03Save generated images to a chosen directory

MCP support

It exposes image generation, task-status checking, and image-download tools to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Ali-Flux MCP Server

中文文档

A Model Context Protocol server for Alibaba Cloud DashScope API

This is a TypeScript-based MCP server that provides functionality to interact with Alibaba Cloud DashScope API for generating images and saving them locally. It demonstrates core MCP concepts by providing:

  • Tools for generating images using Alibaba Cloud DashScope API
  • Tools for checking task status
  • Tools for downloading generated images and saving them locally

Features

Tools

  • generate_image - Generate images using Alibaba Cloud DashScope API

    • Takes prompt as required parameter
    • Optional parameters: size, seed, steps
    • Submits image generation task to DashScope API

  • check_task_status - Check image generation task status

    • Takes task_id as required parameter
    • Returns the current status of the image generation task

  • download_image - Download generated images and save them locally

    • Takes task_id as required parameter
    • Optional parameter: save_path for custom save location (must be an absolute path)
    • Optional parameter: base_dir for resolving relative paths (defaults to WORK_DIR environment variable)
    • Downloads all generated images and saves them to the specified directory

Development

Prerequisites
  • Node.js and npm
  • Alibaba Cloud DashScope API key
Environment Variables
  • DASHSCOPE_API_KEY: Your Alibaba Cloud DashScope API key
  • SAVE_DIR: Directory to save generated images (default: ~/Desktop/flux-images)
  • MODEL_NAME: DashScope model name (default: flux-merged)
  • WORK_DIR: Work directory (default: process.cwd())
Setup

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

Configuration

To use with Claude Desktop or other MCP-compatible clients, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On 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
      }
    }
  }
}
Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.