pixx.io MCP Server

Verbindet KI-Assistenten (Claude Desktop, VS Code Copilot, Cursor u.a.) mit der pixx.io API über das Model Context Protocol (MCP). Der Server übersetzt die pixx.io OpenAPI-Spezifikation automatisch in MCP-Tools – ohne manuelle Konfiguration.

Voraussetzungen

• Node.js ≥ 20
• Ein pixx.io-Account mit API-Key

Ein API-Key kann im Mediaspace unter Einstellungen → API → API-Key → Neuen Key erstellen angelegt werden.

Schnellstart

Der Server kann direkt über npx gestartet werden – ohne vorherige Installation:

PIXXIO_BASE_URL=https://mein-mediaspace.px.media PIXXIO_API_KEY=mein-key npx @pixx.io/mcp-server

Konfiguration

Der Server wird ausschließlich über Umgebungsvariablen konfiguriert:

| Variable | Pflicht | Beschreibung | | ------------------ | ------- | -------------------------------------------------------------------- | | PIXXIO_BASE_URL | ✅ | URL des pixx.io Mediaspace, z. B. https://mein-mediaspace.px.media | | PIXXIO_API_KEY | ✅ | API-Key des pixx.io-Accounts | | LOG_LEVEL | – | debug | info | warn | error (Standard: info) | | HTTP_MAX_RETRIES | – | Max. Wiederholungen bei Server-Fehlern (Standard: 3) |

MCP-Client-Konfiguration

Claude Desktop

Konfigurationsdatei: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pixx.io": {
      "command": "npx",
      "args": ["-y", "@pixx.io/mcp-server"],
      "env": {
        "PIXXIO_BASE_URL": "https://mein-mediaspace.px.media",
        "PIXXIO_API_KEY": "mein-key"
      }
    }
  }
}

VS Code (GitHub Copilot)

Konfigurationsdatei: .vscode/mcp.json im Workspace oder in den User Settings:

{
  "servers": {
    "pixx.io": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@pixx.io/mcp-server"],
      "env": {
        "PIXXIO_BASE_URL": "https://mein-mediaspace.px.media",
        "PIXXIO_API_KEY": "mein-key"
      }
    }
  }
}

Cursor

Einstellungen → MCP → Server hinzufügen:

{
  "mcpServers": {
    "pixx.io": {
      "command": "npx",
      "args": ["-y", "@pixx.io/mcp-server"],
      "env": {
        "PIXXIO_BASE_URL": "https://mein-mediaspace.px.media",
        "PIXXIO_API_KEY": "mein-key"
      }
    }
  }
}

Claude Code

Ein Terminal öffnen und folgenden Befehl ausführen:

claude mcp add --transport stdio \
  --env PIXXIO_BASE_URL=https://mein-mediaspace.px.media \
  --env PIXXIO_API_KEY=mein-key \
  pixx.io -- npx -y @pixx.io/mcp-server

Verfügbare Tools

Der Server generiert beim Start automatisch ein MCP-Tool pro pixx.io API-Endpoint. Die Tool-Namen entsprechen der operationId aus der OpenAPI-Spezifikation (z. B. FilesGet, FilePost, DirectoriesTree).

Sicherheitshinweise

• API-Key und Base-URL ausschließlich über Umgebungsvariablen übergeben – niemals in Code oder Konfigurationsdateien committen.
• Der Server sendet alle Anfragen direkt an deinen pixx.io Mediaspace.

Weiterentwicklung

Informationen zur Architektur und lokalen Entwicklung: CONTRIBUTING.md