mmx-mcp-server

Ein einheitlicher MiniMax multimodaler MCP-Server, basierend auf dem mmx CLI, der Text, Suche, Bildverständnis, Bilderzeugung, Sprachsynthese, Videoerzeugung, Musikerzeugung und Kontingentabfragen unterstützt.

English README

Schnellstart (Ein-Satz-Konfiguration)

Wenn Sie Claude Code, OpenCode oder andere KI-CLI-Tools verwenden, die MCP unterstützen, geben Sie der KI einfach den folgenden Befehl:

Hilf mir bei der Installation und Konfiguration von mmx-mcp-server:

1. Installiere mmx-cli global (npm install -g mmx-cli)

2. Klone https://github.com/zth0828/mmx-mcp-server in ein beliebiges Verzeichnis und führe npm install && npm run build aus

3. Füge den mmx Server zu meiner MCP-Konfigurationsdatei (z. B. ~/.claude/settings.json) hinzu, die auf das Build-Ergebnis dist/index.js verweist

4. Frage mich nach dem MiniMax API Key und injiziere ihn über env.MINIMAX_API_KEY

5. Informiere mich nach Abschluss über das Konfigurationsergebnis

Manuelle Installation

1. mmx CLI installieren (falls noch nicht geschehen)

npm install -g mmx-cli

Installation verifizieren:

mmx --version

2. MCP Server installieren und bauen

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

3. API Key konfigurieren

Fügen Sie dies in der MCP-Client-Konfiguration (z. B. ~/.claude/settings.json) hinzu:

Methode 1: API Key über Umgebungsvariablen übergeben (empfohlen)

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

Methode 2: API Key über Befehlszeilenargumente übergeben

Geeignet für MCP-Clients, bei denen das Schreiben von env nicht möglich ist:

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

Methode 3: Abhängigkeit von der lokalen mmx CLI-Anmeldung

Wenn die ersten beiden Methoden nicht konfiguriert sind, greift der Server automatisch auf den Authentifizierungsstatus der mmx CLI zurück (erfordert die vorherige Ausführung von mmx auth login --api-key sk-xxxxx). Diese Methode ist nur für die lokale Nutzung geeignet.

Benutzerdefiniertes Ausgabeverzeichnis (optional)

Standardmäßig werden generierte Bilder, Videos, Musik und Sprachdateien automatisch in Unterordnern des aktuellen Arbeitsverzeichnisses gespeichert:

• mmx_image/ — Bilder

• mmx_video/ — Videos

• mmx_music/ — Musik

• mmx_speech/ — Sprache

Wenn Sie diese zentral an einem anderen Ort speichern möchten, können Sie dies über die Umgebungsvariable MMX_OUTPUT_DIR ändern:

{
  "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"
      }
    }
  }
}

Die Nichtkonfiguration von MMX_OUTPUT_DIR beeinträchtigt die Nutzung in keiner Weise; die Dateien werden automatisch im aktuellen Projektverzeichnis abgelegt.

Bei jedem Aufruf kann der Ausgabepfad für eine einzelne Datei auch über den Parameter out angegeben werden.

Verfügbare Tools

Anwendungsbeispiele

Nach der Konfiguration können Sie in Claude Code direkt sagen:

"Suche nach den neuesten Nachrichten zu MiniMax" "Analysiere dieses UI-Design und gib Optimierungsvorschläge" "Generiere ein Bild einer städtischen Nachtszene im Cyberpunk-Stil" "Wandle diesen Text in Sprache um"