mmx-mcp-server

mmx CLIをベースに構築された、統合型MiniMax全モーダルMCPサーバーです。テキスト、検索、画像理解、画像生成、音声合成、動画生成、音楽生成、およびクォータ照会をサポートしています。

English README

クイックスタート（ワンライナー設定）

Claude Code、OpenCode、またはその他のMCP対応AI CLIツールを使用している場合は、以下の指示をそのままAIに伝えてください：

mmx-mcp-serverのインストールと設定を手伝ってください：

1. mmx-cliをグローバルインストールする（npm install -g mmx-cli）

2. https://github.com/zth0828/mmx-mcp-server を任意のディレクトリにクローンし、npm install && npm run build を実行する

3. MCP設定ファイル（例：~/.claude/settings.json）に mmx サーバーを追加し、ビルド成果物 dist/index.js を指定する

4. MiniMax API Keyを要求し、env.MINIMAX_API_KEY を通じて注入する

5. 完了したら設定結果を報告する

手動インストール

1. mmx CLIのインストール（未インストールの場合）

npm install -g mmx-cli

インストールの確認：

mmx --version

2. MCP Serverのインストールとビルド

git clone https://github.com/zth0828/mmx-mcp-server.git
cd mmx-mcp-server
npm install
npm run build

3. API Keyの設定

MCPクライアントの設定（例：~/.claude/settings.json）に以下を追加します：

方法1：環境変数でAPI Keyを渡す（推奨）

{
  "mcpServers": {
    "mmx": {
      "command": "node",
      "args": ["/path/to/mmx-mcp-server/dist/index.js"],
      "env": {
        "MINIMAX_API_KEY": "sk-xxxxx"
      }
    }
  }
}

方法2：コマンドライン引数でAPI Keyを渡す

envの設定が難しいMCPクライアントに適しています：

{
  "mcpServers": {
    "mmx": {
      "command": "node",
      "args": [
        "/path/to/mmx-mcp-server/dist/index.js",
        "--api-key",
        "sk-xxxxx"
      ]
    }
  }
}

方法3：mmx CLIのローカルログインに依存する

上記2つの方法が設定されていない場合、サーバーは mmx CLI自身の認証状態に自動的にフォールバックします（事前に mmx auth login --api-key sk-xxxxx を実行する必要があります）。この方法はローカル環境での使用にのみ適しています。

出力ディレクトリのカスタマイズ（オプション）

デフォルトでは、生成された画像、動画、音楽、音声は 現在の作業ディレクトリ 内のサブフォルダに自動保存されます：

• mmx_image/ — 画像

• mmx_video/ — 動画

• mmx_music/ — 音楽

• mmx_speech/ — 音声

別の場所にまとめて保存したい場合は、環境変数 MMX_OUTPUT_DIR で変更可能です：

{
  "mcpServers": {
    "mmx": {
      "command": "node",
      "args": ["/path/to/mmx-mcp-server/dist/index.js"],
      "env": {
        "MINIMAX_API_KEY": "sk-xxxxx",
        "MMX_OUTPUT_DIR": "/Users/xxx/Downloads/mmx-output"
      }
    }
  }
}

MMX_OUTPUT_DIR を設定しなくても問題ありません。ファイルは自動的に現在のプロジェクトディレクトリに保存されます。

呼び出しごとに out パラメータを使用して、個別のファイルの出力パスを指定することも可能です。

提供されるツール

使用例

設定完了後、Claude Codeで直接以下のように指示できます：

"MiniMaxの最新ニュースを検索して" "このUIデザイン図を分析して、改善案を提示して" "サイバーパンク風の都市の夜景画像を生成して" "このテキストを音声に変換して"