mdx-cli

MDX 1 クラウドインフラプラットフォームの非公式CLIツール。

Web ポータル (oprpl.mdx.jp) の操作をコマンドラインから実行できます。VM の一括作成・起動・停止、SSH接続、ネットワーク管理、DNAT/ACL 設定、プロジェクトの資源・ポイント・利用状況の確認などに対応。

前提条件

• oprpl.mdx.jp および mdxidm.mdx.jp への疎通が必要です。
• ソースから入れる場合のみ Python 3.13+ と uv（バイナリは単体で動きます）

インストール

uv版からバイナリ版へ切り替える場合

これまで uv tool install . で導入していた場合は、uv の実行リンクと単体バイナリが 競合しないよう、先にuv版を削除します。~/.config/mdx-cli の設定・認証情報は残ります。

uv tool uninstall mdx-cli

削除後、以下のOS別インストーラを実行してください。インストーラもuv版を検出した場合は 上書きせず、この移行手順を案内して終了します。

バイナリ（推奨）

macOS / Linux:

curl -fsSL https://github.com/aida0710/mdx-cli/releases/latest/download/install.sh | sh

Windows (PowerShell):

irm https://github.com/aida0710/mdx-cli/releases/latest/download/install.ps1 | iex

• 置き先は root なら /usr/local/bin、それ以外は ~/.local/bin（Windows は %LOCALAPPDATA%\Programs\mdx）。MDX_INSTALL_DIR で変更できます
• 版を固定する場合は、macOS / Linux では curl -fsSL https://github.com/aida0710/mdx-cli/releases/latest/download/install.sh | MDX_VERSION=v2.2.0 sh、 Windows では実行前に $env:MDX_VERSION = 'v2.2.0' を設定します
• リリースの checksums.txt で SHA-256 を照合し、取得不能・不一致ならインストールしません
• アップデートは同じコマンドの再実行
• 配布しているのは macOS(arm64) / Linux(x86_64, arm64) / Windows(x86_64) です
• Linux版は glibc 2.35 以降（Ubuntu 22.04 以降）で動きます
• Python実行環境を同梱したアーカイブをインストール時に展開します。毎回の起動時には展開しません
• macOS / Linuxでは実体をインストール先の .mdx-runtime/ に配置し、mdx からリンクします。Windowsでは mdx.exe と _internal/ を一緒に配置します
• mdx のリンクや実行ファイルだけを別端末へコピーせず、その端末でもインストーラを実行してください
• macOS / Linuxでは実行中プロセスのため旧runtimeを残します

ソースから（uv）

uv tool install .

アップデート:

git pull
uv tool install . --force

インストール後の確認:

mdx --version

シェル補完

Tabキーでサブコマンドやオプションを補完するには、使っているシェルで一度だけ次を実行し、ターミナルを開き直します。

mdx --install-completion

bash・zsh・fish・PowerShellに対応しています。補完の候補は毎回 mdx 自身が返すため、アップデート後に入れ直す必要はありません。

Skill としてインストール

AIエージェントによる、プロジェクト情報の変更を伴う申請系操作とMDX運営側の対応を発生させる操作はすべて禁止です。 詳細は スキルの禁止事項 を参照してください。

Codex / Claude Code の skill として使う場合:

curl -fsSL https://raw.githubusercontent.com/aida0710/mdx-cli/main/agent-skill-install.sh | sh

ローカルのこのリポジトリから入れる場合:

sh agent-skill-install.sh --source . --codex-only

リリース

リリース担当者はcleanなmainで、現在より大きい安定版SemVerを指定します。

./release.sh --dry-run 2.2.0  # 事前条件だけ確認
./release.sh 2.2.0            # 確認後、main CI・タグ・Release CIまで実行

同名タグ、現在以下のversion、未commit変更、origin/mainと同期していない状態では停止します。 非対話実行で確認を省略する場合だけ--yesを追加します。

プロジェクトの利用状況を確認する

ログインして mdx project select で対象を選んだら、以下のコマンドで確認できます。

mdx project overview          # 資源・VM状態を項目ごとに表示
mdx project points            # ポイント明細と合計残高
mdx project usage --hours 24  # 直近の正時（JST）までの24時間の消費ポイント

資源・ユーザー一覧、期間指定、JSON・HTML出力の詳細は、 プロジェクトと利用状況をご覧ください。

ドキュメント

インストール後のクイックスタート、認証、VM・ネットワークの操作、設定については、 mdx-cli ドキュメントをご覧ください。