mediamcp

Bringen Sie jedem KI-Agenten bei, Bilder und Videos zu erstellen

mediamcp ist ein MCP-Server, der Ihren KI-Assistenten – Claude Code, Claude Desktop, Cursor, Windsurf, VS Code oder einen anderen MCP-fähigen Client – mit Cloud-Medienmodellen verbindet (Gemini Flash Image, GPT-5 Image, Seedream, Veo, Sora, …) über OpenRouter oder eine beliebige OpenAI-kompatible API.

English | Deutsch

⭐ Das Banner oben wurde von mediamcp selbst erzeugt – ein einziger Aufruf von generate_image.

Generierte Dateien werden immer auf der Festplatte gespeichert (standardmäßig in ~/Pictures/mediamcp), und jede Antwort enthält den absoluten Pfad zur Datei sowie eine kleine eingebettete Vorschau – der Agent sieht sofort, was er erstellt hat.

An KI-Agenten: Eine speziell für Sie optimierte Installationsanleitung finden Sie in llms-install.md.

Sie benötigen einen OpenRouter-API-Schlüssel – Sie erhalten ihn unter https://openrouter.ai/keys.

Schnellinstallation

Claude Code

claude mcp add mediamcp -e OPENROUTER_API_KEY=sk-or-v1-YOUR_KEY -- npx -y mediamcp

Claude Desktop

Fügen Sie Folgendes in claude_desktop_config.json ein (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json) und starten Sie Claude Desktop neu:

{
  "mcpServers": {
    "mediamcp": {
      "command": "npx",
      "args": ["-y", "mediamcp"],
      "env": { "OPENROUTER_API_KEY": "sk-or-v1-YOUR_KEY" }
    }
  }
}

Cursor

Oder fügen Sie Folgendes in ~/.cursor/mcp.json ein:

{
  "mcpServers": {
    "mediamcp": {
      "command": "npx",
      "args": ["-y", "mediamcp"],
      "env": { "OPENROUTER_API_KEY": "sk-or-v1-YOUR_KEY" }
    }
  }
}

Windsurf

Fügen Sie Folgendes in ~/.codeium/windsurf/mcp_config.json ein:

{
  "mcpServers": {
    "mediamcp": {
      "command": "npx",
      "args": ["-y", "mediamcp"],
      "env": { "OPENROUTER_API_KEY": "sk-or-v1-YOUR_KEY" }
    }
  }
}

VS Code (GitHub Copilot)

Oder fügen Sie Folgendes in .vscode/mcp.json ein (der Schlüssel wird separat abgefragt und landet nicht in der Datei):

{
  "servers": {
    "mediamcp": {
      "command": "npx",
      "args": ["-y", "mediamcp"],
      "env": { "OPENROUTER_API_KEY": "${input:openrouter-key}" }
    }
  },
  "inputs": [
    {
      "id": "openrouter-key",
      "type": "promptString",
      "password": true,
      "description": "OpenRouter API key (https://openrouter.ai/keys)"
    }
  ]
}

Related MCP server: mcp-media-engine

Was Ihr Agent können wird

Nach der Installation sagen Sie dem Agenten einfach etwas wie „Erzeuge ein Hero-Bild für meine Landingpage, 16:9", „Entferne den Hintergrund von logo.png", „Erstelle ein 8-Sekunden-Video mit Meereswellen bei Sonnenuntergang" oder „Erwecke logo.png zu einem 4-Sekunden-Video" (Image-to-Video). Der Agent wählt selbst das passende Werkzeug aus:

Konfiguration

Alles wird über Umgebungsvariablen im env-Block der Konfiguration Ihres MCP-Clients eingestellt:

Einen anderen Anbieter verwenden

Geben Sie in MEDIAMCP_BASE_URL einen beliebigen OpenAI-kompatiblen Endpunkt an und legen Sie den passenden Schlüssel fest:

"env": {
  "MEDIAMCP_BASE_URL": "https://your-endpoint.example.com/v1",
  "MEDIAMCP_API_KEY": "your-key",
  "MEDIAMCP_MODEL": "your/image-model"
}

mediamcp erkennt selbst, welches API-Format der Endpunkt unterstützt: dedizierter /images-Endpunkt (OpenRouter), /images/generations (klassisches OpenAI) oder chat/completions mit Bildunterstützung – die erste erfolgreiche Variante wird gespeichert.

Fehlerbehebung

1. Bitten Sie den Agenten, das Werkzeug check_config auszuführen – es teilt Ihnen mit, was falsch konfiguriert ist und wie Sie es beheben.

2. Dieselbe Diagnose können Sie im Terminal ausführen: npx -y mediamcp --check (es werden die Umgebungsvariablen Ihrer Shell verwendet).

3. Häufige Probleme:

   • „No API key configured" – fügen Sie OPENROUTER_API_KEY zum env-Block des Servereintrags in der MCP-Client-Konfiguration hinzu (nicht nur im Shell-Profil) und starten Sie den Client neu.

   • „Out of credits (HTTP 402)" – laden Sie Ihr Guthaben unter https://openrouter.ai/credits auf.

   • „Not found (HTTP 404) … for model" – falscher Modell-Slug; führen Sie list_models aus.

   • Im Client passiert nichts – stellen Sie sicher, dass Node.js ≥ 20 installiert ist (node --version).

   • „Tool '…' has an invalid outputSchema … unsupported dialect" – der Client prüft Schemas nur gegen JSON Schema 2020-12. mediamcp veröffentlicht standardmäßig 2020-12. Der Fehler bedeutet also eine alte Version: Aktualisieren Sie und stellen Sie sicher, dass check_config tool schema dialect: 2020-12 anzeigt.

Entwicklung

git clone https://github.com/legolev/mediamcp && cd mediamcp
npm install
npm run build       # сборка в dist/index.js
npm test            # юнит-тесты (vitest)
npm run inspect     # открыть MCP Inspector с собранным сервером

Lizenz

MIT

mcp-name: io.github.legolev/mediamcp