Configuration MCP de Claude Code : npm vs uvx et pièges

Introduction

Quand vous essayez pour la première fois de configurer un serveur MCP pour Claude Code ou Claude Desktop, vous heurterez probablement ce mur :

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

Cette erreur se produit parce que vous utilisez uvx pour chercher un package npm. L'écosystème MCP mélange des serveurs basés sur npm et uvx, et vous devez savoir lequel est lequel.

npm-Based vs uvx-Based

Règle générale :

Serveurs MCP officiels   → npm
Spécifiques à Android   → uvx

Pourquoi uvx mcp-server-filesystem échoue

Une erreur courante :

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

Cette configuration indique à uvx de chercher mcp-server-filesystem sur PyPI — mais ce package n'existe pas sur PyPI.

@modelcontextprotocol/server-filesystem est un package npm Node.js. uvx est un gestionnaire de packages Python et ne le trouvera pas.

La bonne façon de configurer filesystem MCP

Étape 1 : Installer via npm

npm install -g @modelcontextprotocol/server-filesystem

Étape 2 : Trouver le chemin installé (Windows)

where mcp-server-filesystem

Il est généralement installé à :

C:\Users\<username>\AppData\Roaming\npm\mcp-server-filesystem.cmd

Étape 3 : Ajouter à settings.json

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

Si la commande n'est pas dans votre PATH, utilisez le chemin complet :

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

Mises en garde spécifiques à Windows

Séparateurs de chemin — utilisez des doubles barres obliques inversées :

"C:\\Users\\nobuy\\Code"   // ✓ Correct
"C:/Users/nobuy/Code"       // ✓ Ceci fonctionne aussi
"/Users/Code"                // ✗ N'existe pas sous Windows

L'extension .cmd peut être requise :

Les installations globales npm sur Windows créent des fichiers .cmd. Si le nom de commande seul ne fonctionne pas, spécifiez le chemin complet .cmd.

Pourquoi vous pouvez ignorer fetch MCP pour l'instant

@modelcontextprotocol/server-fetch n'existe pas comme package npm officiel.

# Ceci échouera
npm install -g @modelcontextprotocol/server-fetch
# npm error 404 Not Found

Les MCP de type fetch proviennent d'implémentations individuelles, de clones GitHub ou d'outils comme Smithery — les méthodes d'installation varient considérablement.

Plus important, Claude Code lui-même dispose déjà de la recherche web et de la récupération d'URL intégrées, donc fetch MCP est peu prioritaire pour le développement Android/Compose.

Configuration d'Android MCP (basé sur uvx)

Les MCP d'automatisation d'appareils Android sont basés sur uvx :

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

uvx gère l'environnement Python automatiquement, donc aucune configuration manuelle de venv n'est requise — ce qui est pratique.

Configuration finale recommandée

Pour le développement Android avec Claude Code :

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

Guide de priorité

Configurer filesystem en premier est l'étape au ROI le plus élevé — cela permet à Claude Code de travailler avec une pleine conscience de votre codebase.

Résumé

Commencer avec juste filesystem et Android MCP vous donne une configuration étonnamment puissante dès le départ.