Paperless MCP

Paperless MCP s’exécute en local depuis un paquet Python publié sur PyPI : pvliesdonk-paperless-mcp, version 3.0.0. Il communique en MCP via stdio : le client le lance comme un programme et échange avec lui par l’entrée et la sortie standard. Il nécessite Python ; les clients le lancent généralement avec uvx (fourni par uv) ou après pip install - la commande habituelle est uvx pvliesdonk-paperless-mcp. Il lit ces variables d’environnement : PAPERLESS_MCP_KV_STORE_URL, PAPERLESS_MCP_TOOLS_ALLOW, PAPERLESS_MCP_TOOLS_DENY, PAPERLESS_MCP_SERVER_NAME, PAPERLESS_MCP_INSTANCE_DESCRIPTION, PAPERLESS_MCP_INSTRUCTIONS_EXTRA, PAPERLESS_MCP_INSTRUCTIONS, PAPERLESS_MCP_LOG_LEVEL, PAPERLESS_MCP_LOG_FORMAT, PAPERLESS_MCP_PAPERLESS_URL, PAPERLESS_MCP_API_TOKEN (secret), PAPERLESS_MCP_HTTP_TIMEOUT_SECONDS, PAPERLESS_MCP_HTTP_RETRIES, PAPERLESS_MCP_DEFAULT_PAGE_SIZE, PAPERLESS_MCP_PAPERLESS_PUBLIC_URL, PAPERLESS_MCP_TRANSFER_TTL_DEFAULT_S, PAPERLESS_MCP_TRANSFER_TTL_MAX_S, PAPERLESS_MCP_TRANSFER_GRACE_TTL_S, PAPERLESS_MCP_TRANSFER_LEASE_S et PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES ; définissez-les dans la configuration du client pour ce serveur.

Paperless MCP s’exécute en local depuis une image de conteneur hébergée dans un registre OCI comme Docker Hub ou GitHub Container Registry : ghcr.io/pvliesdonk/paperless-mcp:v3.0.0. Le paquet lance un serveur local qui communique en MCP via Streamable HTTP ; le client s’y connecte ensuite par URL. Il lit ces variables d’environnement : PAPERLESS_MCP_SHUTDOWN_GRACE_S, PAPERLESS_MCP_BASE_URL, PAPERLESS_MCP_BEARER_TOKEN (secret), PAPERLESS_MCP_OIDC_CONFIG_URL, PAPERLESS_MCP_OIDC_CLIENT_ID, PAPERLESS_MCP_OIDC_CLIENT_SECRET (secret), PAPERLESS_MCP_OIDC_AUDIENCE, PAPERLESS_MCP_OIDC_REQUIRED_SCOPES, PAPERLESS_MCP_OIDC_ADVERTISED_SCOPES, PAPERLESS_MCP_OIDC_JWT_SIGNING_KEY (secret), PAPERLESS_MCP_OIDC_VERIFY_ACCESS_TOKEN, PAPERLESS_MCP_KV_STORE_URL, PAPERLESS_MCP_APP_DOMAIN, PAPERLESS_MCP_TOOLS_ALLOW, PAPERLESS_MCP_TOOLS_DENY, PAPERLESS_MCP_AUTH_MODE, PAPERLESS_MCP_BEARER_TOKENS_FILE, PAPERLESS_MCP_BEARER_DEFAULT_SUBJECT, PAPERLESS_MCP_SERVER_NAME et PAPERLESS_MCP_INSTANCE_DESCRIPTION ; définissez-les dans la configuration du client pour ce serveur.

Au format JSON mcpServers, que lisent de nombreux clients MCP de bureau et éditeurs de code, l’entrée se présente ainsi (espaces réservés entre chevrons) :

{
  "mcpServers": {
    "paperless-mcp": {
      "command": "uvx",
      "args": [
        "pvliesdonk-paperless-mcp"
      ],
      "env": {
        "PAPERLESS_MCP_KV_STORE_URL": "<valeur>",
        "PAPERLESS_MCP_TOOLS_ALLOW": "<valeur>",
        "PAPERLESS_MCP_TOOLS_DENY": "<valeur>",
        "PAPERLESS_MCP_SERVER_NAME": "<valeur>",
        "PAPERLESS_MCP_INSTANCE_DESCRIPTION": "<valeur>",
        "PAPERLESS_MCP_INSTRUCTIONS_EXTRA": "<valeur>",
        "PAPERLESS_MCP_INSTRUCTIONS": "<valeur>",
        "PAPERLESS_MCP_LOG_LEVEL": "<valeur>",
        "PAPERLESS_MCP_LOG_FORMAT": "<valeur>",
        "PAPERLESS_MCP_PAPERLESS_URL": "<valeur>",
        "PAPERLESS_MCP_API_TOKEN": "<secret>",
        "PAPERLESS_MCP_HTTP_TIMEOUT_SECONDS": "<valeur>",
        "PAPERLESS_MCP_HTTP_RETRIES": "<valeur>",
        "PAPERLESS_MCP_DEFAULT_PAGE_SIZE": "<valeur>",
        "PAPERLESS_MCP_PAPERLESS_PUBLIC_URL": "<valeur>",
        "PAPERLESS_MCP_TRANSFER_TTL_DEFAULT_S": "<valeur>",
        "PAPERLESS_MCP_TRANSFER_TTL_MAX_S": "<valeur>",
        "PAPERLESS_MCP_TRANSFER_GRACE_TTL_S": "<valeur>",
        "PAPERLESS_MCP_TRANSFER_LEASE_S": "<valeur>",
        "PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<valeur>"
      }
    }
  }
}

Déduit de l’entrée du registre, non testé ici. Ce que fait le serveur, et à quelles conditions, relève de son éditeur ; consultez son dépôt ou son site web avant de lui donner accès à vos comptes ou à vos fichiers. Comment ajouter un serveur MCP à un assistant · Avant de connecter un serveur