MCP-Server für Claude Code einrichten — npm vs. uvx und häufige Fallstricke

Einführung

Wenn Sie versuchen, einen MCP-Server in Claude Code oder Claude Desktop zu konfigurieren, stoßen Sie schnell auf ein Problem:

mcp-server-filesystem was not found in the package registry

Dieser Fehler tritt auf, weil uvx versucht, npm-Pakete zu finden. Das MCP-Ökosystem besteht aus einer Mischung aus npm- und uvx-basierten Servern, und Sie benötigen Wissen, um die richtige Wahl zu treffen.

npm-Typ vs. uvx-Typ

Grundlegende Richtlinie:

Offizielle MCP     → npm
Android-spezifisch → uvx

Warum uvx mcp-server-filesystem fehlschlägt

Ein häufiger Fehler:

{
  "mcpServers": {
    "filesystem": {
      "command": "uvx",
      "args": ["mcp-server-filesystem"]
    }
  }
}

Diese Konfiguration versucht, mcp-server-filesystem von PyPI zu suchen, aber dieses Paket existiert auf PyPI nicht.

@modelcontextprotocol/server-filesystem ist ein Node-basiertes npm-Paket. Da uvx ein Python-Paketmanager ist, kann es dieses nicht finden.

Korrekte Konfiguration für filesystem MCP

Schritt 1: Installation mit npm

npm install -g @modelcontextprotocol/server-filesystem

Schritt 2: Installationsort überprüfen (Windows)

where mcp-server-filesystem

Normalerweise wird es an folgendem Pfad installiert:

C:\Users\Benutzername\AppData\Roaming\npm\mcp-server-filesystem.cmd

Schritt 3: In settings.json konfigurieren

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-server-filesystem",
      "args": [
        "C:\\Users\\nobuy\\Code"
      ]
    }
  }
}

Wenn der PATH nicht gesetzt ist, verwenden Sie den vollständigen Pfad:

{
  "mcpServers": {
    "filesystem": {
      "command": "C:\\Users\\nobuy\\AppData\\Roaming\\npm\\mcp-server-filesystem.cmd",
      "args": [
        "C:\\Users\\nobuy\\Code"
      ]
    }
  }
}

Besonderheiten unter Windows

Pfadtrennzeichen müssen doppelte Backslashes sein:

"C:\\Users\\nobuy\\Code"   // ○ Korrekt
"C:/Users/nobuy/Code"       // ○ Funktioniert auch
"/Users/Code"                // ✕ Existiert unter Windows nicht

Die .cmd-Erweiterung kann erforderlich sein:

npm installiert Pakete unter Windows als .cmd-Dateien. Wenn der Befehl allein nicht funktioniert, verwenden Sie den vollständigen Pfad mit .cmd-Erweiterung.

Warum fetch MCP später kommt

@modelcontextprotocol/server-fetch existiert nicht als offizielles npm-Paket.

# Dies wird zu einem Fehler führen
npm install -g @modelcontextprotocol/server-fetch
# npm error 404 Not Found

Die Installationsmethoden für fetch-basierte MCPs sind unterschiedlich — persönliche Implementierungen, GitHub-Klone, über smithery, usw.

Da Claude Code bereits eigene Web-Such- und URL-Abruf-Funktionen hat, ist die Priorität für fetch MCP bei Android/Compose-Entwicklung niedrig.

Konfiguration von Android MCP (uvx-Typ)

MCPs für Android-Gerätesteuerung sind uvx-basiert.

{
  "mcpServers": {
    "android": {
      "command": "C:\\Users\\nobuy\\.local\\bin\\uvx.exe",
      "args": [
        "--python", "3.13",
        "android-mcp"
      ]
    }
  }
}

uvx verwaltet die Python-Umgebung automatisch, sodass Sie zuvor kein venv erstellen müssen — das ist sehr praktisch.

Empfohlene Endkonfiguration

Wenn Sie Claude Code für Android-Entwicklung verwenden, ist dies die empfohlene Konfiguration:

{
  "mcpServers": {
    "filesystem": {
      "command": "C:\\Users\\nobuy\\AppData\\Roaming\\npm\\mcp-server-filesystem.cmd",
      "args": [
        "C:\\Users\\nobuy\\Code"
      ]
    },
    "android": {
      "command": "C:\\Users\\nobuy\\.local\\bin\\uvx.exe",
      "args": [
        "--python", "3.13",
        "android-mcp"
      ]
    }
  }
}

Prioritätsdenken

Wenn Sie filesystem zuerst installieren, kann Claude Code mit einem vollständigen Verständnis des Codes arbeiten — das hat das beste Kosten-Nutzen-Verhältnis.

Zusammenfassung

Am Anfang genügen filesystem und Android MCP — Sie haben bereits eine sehr leistungsstarke Umgebung.