Ali Flux MCP

🚀 阿里云DashScope APIのModel Context Protocol（MCP）サーバー

このサーバーは、TypeScriptをベースに構築されたMCPサーバーで、阿里云DashScope APIとのやり取りを通じて、画像生成とローカル保存機能を実現します。このサーバーは、以下のような核心的なMCP概念をデモンストレーションしています。

• 阿里云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を提供します。