Windsurf + pdfmcp : guide d'installation

Ajoutez pdfmcp à Windsurf Cascade via mcp_config.json.

Uniquement local. Les mêmes 74 outils, sur votre machine : sans compte, sans clé, sans limites. Avec Windsurf, la configuration de cette page exécute pdfmcp sur votre machine ; vous pouvez réinstaller ou changer de client à tout moment en échangeant la configuration.

Ce qu'il vous faut : le paquet pdfmcp local : installez-le une fois (ou laissez uvx le télécharger au premier lancement). Sans compte, sans clé et sans secret à remplacer.

Où ça va : Wherever your client keeps its MCP server list

{
  "mcpServers": {
    "pdfmcp": {
      "command": "uvx",
      "args": [
        "--from",
        "https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl",
        "pdfmcp"
      ]
    }
  }
}

Étapes

1. Save the config at the location above — uvx fetches the pdfmcp package on first launch, so there is nothing to install by hand (or install it once with the pip command on the MCP page and use "command": "pdfmcp").
2. Restart Windsurf so it loads the new server.
3. Ask the agent to run a pdfmcp tool — it executes on this machine, and your files never leave it.

Dépannage

• Le serveur local ne démarre pas : installez le paquet une fois avec pip install https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl et lancez pdfmcp dans un terminal pour voir l'erreur — en général un téléchargement de paquet bloqué, ou Python antérieur à 3.11.
• Les outils n'apparaissent pas : redémarrez complètement le client après avoir modifié sa configuration ; la plupart des clients ne chargent les serveurs MCP qu'au démarrage.
• Un moteur ne démarre pas : les moteurs lourds se téléchargent une seule fois au premier usage ; vérifiez votre connexion pour ce téléchargement et réessayez : ensuite tout fonctionne localement.

Essayez avec

Plus de clients : Claude Desktop installation MCP · Claude Code installation MCP · ChatGPT installation MCP · Tous les guides d'installation MCP · Guide de l'API locale