Windsurf + pdfmcp: guía de configuración

Añade pdfmcp a Windsurf Cascade mediante mcp_config.json.

Solo local. Las mismas 74 herramientas, ejecutándose en tu máquina: sin cuenta, sin clave, sin límites. Con Windsurf la configuración de esta página ejecuta pdfmcp en tu máquina; puedes reinstalar o cambiar de cliente cuando quieras intercambiando la configuración.

Qué necesitas: el paquete pdfmcp local: instálalo una vez (o deja que uvx lo descargue en el primer arranque). Sin cuenta, sin clave y sin nada que sustituir por un secreto.

Dónde 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"
      ]
    }
  }
}

Pasos

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.

Solución de problemas

• El servidor local no arranca: instala el paquete una vez con pip install https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl y ejecuta pdfmcp en una terminal para ver el error; suele ser una descarga de paquete bloqueada, o Python anterior a 3.11.
• Las herramientas no aparecen: reinicia por completo el cliente después de editar su configuración; la mayoría de los clientes solo carga los servidores MCP al arrancar.
• Un motor no arranca: los motores pesados se descargan una sola vez en el primer uso; comprueba tu conexión para esa descarga y vuelve a intentarlo: después todo funciona localmente.

Pruébalo con

Más clientes: Claude Desktop configuración MCP · Claude Code configuración MCP · ChatGPT configuración MCP · Todas las guías de configuración MCP · Guía de la API local