Paperless MCP

Paperless MCP רץ באופן מקומי מתוך חבילת Python שפורסמה ב-PyPI: pvliesdonk-paperless-mcp, גרסה 3.0.0. הוא משתמש ב-MCP על גבי stdio, ולכן הלקוח מפעיל אותו כתוכנה ומתקשר איתו דרך קלט ופלט סטנדרטיים. כדי להריץ אותו צריך Python; לקוחות מפעילים אותו בדרך כלל עם uvx (מתוך uv) או אחרי pip install - הפקודה המקובלת היא uvx pvliesdonk-paperless-mcp. הוא קורא את משתני הסביבה האלה: 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 (סודי), 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 ו-PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES; יש להגדיר אותם בתצורת הלקוח עבור השרת הזה.

Paperless MCP רץ באופן מקומי מתוך אימג' של קונטיינר במרשם OCI כמו Docker Hub או GitHub Container Registry: ghcr.io/pvliesdonk/paperless-mcp:v3.0.0. החבילה מפעילה שרת מקומי שמשתמש ב-MCP על גבי Streamable HTTP; לאחר מכן הלקוח מתחבר אליו לפי כתובת URL. הוא קורא את משתני הסביבה האלה: PAPERLESS_MCP_SHUTDOWN_GRACE_S, PAPERLESS_MCP_BASE_URL, PAPERLESS_MCP_BEARER_TOKEN (סודי), PAPERLESS_MCP_OIDC_CONFIG_URL, PAPERLESS_MCP_OIDC_CLIENT_ID, PAPERLESS_MCP_OIDC_CLIENT_SECRET (סודי), PAPERLESS_MCP_OIDC_AUDIENCE, PAPERLESS_MCP_OIDC_REQUIRED_SCOPES, PAPERLESS_MCP_OIDC_ADVERTISED_SCOPES, PAPERLESS_MCP_OIDC_JWT_SIGNING_KEY (סודי), 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 ו-PAPERLESS_MCP_INSTANCE_DESCRIPTION; יש להגדיר אותם בתצורת הלקוח עבור השרת הזה.

בפורמט ה-JSON של mcpServers, שלקוחות MCP רבים לדסקטופ ולעורכי קוד קוראים, הרשומה נראית כך (מצייני מקום בסוגריים זוויתיים):

{
  "mcpServers": {
    "paperless-mcp": {
      "command": "uvx",
      "args": [
        "pvliesdonk-paperless-mcp"
      ],
      "env": {
        "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": "<סוד>",
        "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": "<ערך>",
        "PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<ערך>"
      }
    }
  }
}

נגזר מהרשומה במרשם, ולא נבדק כאן. מה השרת עושה, ובאילו תנאים, נקבע על ידי המפרסם שלו; כדאי לבדוק את מאגר הקוד או את האתר שלו לפני שנותנים לו גישה לחשבונות או לקבצים שלך. איך מוסיפים שרת MCP לעוזר AI · לפני שמתחברים