PDFCheck MCP-Server

Über HTTP verbinden

Add this URL to a client that supports remote HTTP MCP servers. For account access, configure a bearer Authorization header.

https://pdfcheck.online/api/mcp

Ohne Token (10 kostenlose Prüfungen/Tag)

To analyze a PDF, your assistant needs a file-reading tool that can send its base64 contents. Connecting MCP alone does not provide access to your files.

{
    "mcpServers": {
        "pdfcheck": {
            "url": "https://pdfcheck.online/api/mcp"
        }
    }
}

Ersetzen Sie YOUR_API_TOKEN in Ihrer Client-Konfiguration. Entfernen Sie den Authorization-Header für den anonymen Zugriff.

{
    "mcpServers": {
        "pdfcheck": {
            "url": "https://pdfcheck.online/api/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_API_TOKEN"
            }
        }
    }
}

{
    "servers": {
        "pdfcheck": {
            "type": "http",
            "url": "https://pdfcheck.online/api/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_API_TOKEN"
            }
        }
    }
}

{
    "mcpServers": {
        "pdfcheck": {
            "serverUrl": "https://pdfcheck.online/api/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_API_TOKEN"
            }
        }
    }
}

Verbindung prüfen

Bitten Sie Ihren Assistenten zunächst, check_usage aufzurufen. Analysieren Sie dann ein PDF mit einem Client, der die Datei lesen und Base64-kodieren kann. Ein lokaler Dateipfad allein funktioniert nicht über Remote-HTTP.

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "check_usage",
        "arguments": {}
    }
}

Verfügbare MCP-Tools

Diese MCP-Werkzeuge bieten Metadatenanalyse und Kontohistorie. Komprimierung, Strukturprüfung, Signieren und andere Browserwerkzeuge sind über diese Methoden nicht verfügbar.

Send the PDF contents

The analyze_pdf tool accepts file_base64 and filename. Your client must read the PDF and encode it as base64; a local file path alone will not work.

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "analyze_pdf",
        "arguments": {
            "file_base64": "BASE64_PDF_CONTENT",
            "filename": "document.pdf"
        }
    }
}

Antwort lesen

Tool-Ergebnisse enthalten JSON-Text in result.content[0].text. Parsen Sie diesen Text, um success, data und remaining_checks zu lesen; bei Fehlern kann auch isError zurückgegeben werden.

if (response.error) throw new Error(response.error.message);
const payload = JSON.parse(response.result.content[0].text);
if (response.result.isError || payload.success === false) {
  throw new Error(payload.message || payload.error);
}
console.log(payload.data, payload.remaining_checks);

Lokale Bridge verwenden

Speichern Sie die folgende Datei als pdfcheck-mcp-server.mjs an einem beliebigen Ort auf Ihrem Rechner. Dieses leichtgewichtige Skript verbindet Ihr KI-Tool mit der PDFCheck-API.

Das MCP-Server-Skript erfordert Node.js 18 oder neuer. Laden Sie es von nodejs.org herunter, falls Sie es nicht installiert haben.

Speichern Sie das Skript in einem eigenen Verzeichnis, installieren Sie dort seine Abhängigkeiten und verwenden Sie den vollständigen Skriptpfad in Ihrer Client-Konfiguration.

mkdir pdfcheck-mcp
cd pdfcheck-mcp
npm init -y
npm install @modelcontextprotocol/sdk@1 zod

#!/usr/bin/env node
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
import { readFileSync } from "node:fs";
import { basename } from "node:path";

const API_BASE = "https://pdfcheck.online/api/v1";
const TOKEN = process.env.PDFCHECK_API_TOKEN || null;
const headers = TOKEN
  ? { Authorization: `Bearer ${TOKEN}`, Accept: "application/json" }
  : { Accept: "application/json" };

const server = new McpServer({ name: "pdfcheck", version: "1.0.0" });
const result = (data) => ({
  content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
});

server.tool(
  "analyze_pdf",
  "Inspect PDF metadata, dates, software fields, and page count.",
  { filePath: z.string().describe("Absolute path to the PDF file") },
  async ({ filePath }) => {
    const file = new Blob([readFileSync(filePath)], { type: "application/pdf" });
    const body = new FormData();
    body.append("file", file, basename(filePath));
    const response = await fetch(`${API_BASE}/pdf/analyze`, {
      method: "POST", headers, body,
    });
    return result(await response.json());
  }
);

server.tool(
  "get_analysis",
  "Retrieve an accessible analysis by its share token.",
  { token: z.string().describe("Analysis share token") },
  async ({ token }) => {
    const response = await fetch(`${API_BASE}/pdf/${encodeURIComponent(token)}`, { headers });
    return result(await response.json());
  }
);

server.tool("list_analyses", "List your account analyses.", {}, async () => {
  const response = await fetch(`${API_BASE}/pdf`, { headers });
  return result(await response.json());
});

server.tool("check_usage", "Check your account allowance.", {}, async () => {
  const response = await fetch(`${API_BASE}/user`, { headers });
  return result(await response.json());
});

await server.connect(new StdioServerTransport());

Claude / Cursor

Ersetzen Sie den Skriptpfad durch seinen absoluten Pfad. Setzen Sie PDFCHECK_API_TOKEN auf Ihr Kontotoken oder lassen Sie env für anonyme Analysen weg.

{
    "mcpServers": {
        "pdfcheck": {
            "command": "node",
            "args": [
                "/absolute/path/pdfcheck-mcp-server.mjs"
            ],
            "env": {
                "PDFCHECK_API_TOKEN": "YOUR_API_TOKEN"
            }
        }
    }
}

Nutzen Sie diese Prompts mit einem Client, der die angegebenen Dateien lesen kann. Das entfernte analyze_pdf benötigt file_base64 und filename; ein lokaler Pfad allein reicht nicht. Die lokale Brücke akzeptiert filePath.

{
    "name": "analyze_pdf",
    "arguments": {
        "filePath": "/absolute/path/document.pdf"
    }
}

Anwendungsbeispiele

Nutzen Sie diese Prompts mit einem Client, der die angegebenen Dateien lesen kann. Das entfernte analyze_pdf benötigt file_base64 und filename; ein lokaler Pfad allein reicht nicht. Die lokale Brücke akzeptiert filePath.

Eine PDF analysieren

Analysiere die Datei /Users/me/Documents/contract.pdf und sage mir, wann sie erstellt wurde und welche Software verwendet wurde.

Softwarehinweise prüfen

Prüfe die Felder Creator und Producer in /Users/me/Downloads/report.pdf. Erkläre die Softwarehinweise, ohne sie als Beweis für KI-Autorschaft zu behandeln.

Stapelanalyse

Analysiere die von mir ausgewählten PDFs im Downloads-Ordner einzeln. Vergleiche die angegebenen Erstellungs- und Änderungsdaten und erkläre fehlende oder widersprüchliche Metadaten.

Kontingent prüfen

Wie viele PDF-Prüfungen habe ich heute noch auf PDFCheck?

Nutzung und Limits

Anonymous metadata analysis: 10 checks per day per IP. Free account: 100 checks per day. Individual tools can have different limits.

Für die Metadatenanalyse: ohne Konto und mit Free sind Uploads bis 50 MB möglich. Mit Pro und AI sind bis zu 100 MB möglich.

Die Metadatenanalyse der API verwendet einen begrenzten, ressourcenschonenden Modus. Detaillierte Schrift-, Bild- und Farbanalysen werden übersprungen; metadata.basic.partial_analysis ist true.

Metadaten und Softwaremerkmale beweisen weder Urheberschaft noch Authentizität oder die Einhaltung von Standards.

API-Token generieren Optional

Halten Sie Tokens geheim. Verwenden Sie eine Umgebungsvariable und widerrufen Sie ungenutzte Tokens in Ihrem Konto.

Anonymer Zugriff erlaubt 10 Metadatenanalysen pro Tag und IP-Adresse. Ein kostenloses Konto mit API-Token erhält 100 Prüfungen täglich. Verwenden Sie das Token beim Analysieren, wenn Sie das Ergebnis später über Ihr Konto abrufen möchten.

Was ist das Model Context Protocol?

Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Assistenten ermöglicht, sich mit externen Tools und Datenquellen zu verbinden. Stellen Sie es sich als universellen Stecker vor, der Ihren KI-Assistenten mit Diensten wie PDFCheck sprechen lässt — direkt aus Ihrem Chat-Fenster.

Der HTTP-Server erhält die Base64-kodierten PDF-Inhalte von Ihrem Client. Die optionale lokale Brücke liest eine PDF auf Ihrem Computer und lädt sie zur REST API hoch. Beide liefern die Metadatenanalyse als JSON in content[0].text.

Funktioniert überall

Nutzen Sie einen Client, der HTTP-MCP mit Bearer-Headern unterstützt oder eine lokale stdio-Brücke ausführen kann. Verbindungen, die ausschließlich OAuth unterstützen, funktionieren mit dieser Konfiguration nicht.

Die PDF wird über HTTPS an PDFCheck gesendet. Je nach Funktionsweise können auch Ihr MCP-Client oder KI-Anbieter die Datei oder Werkzeugargumente verarbeiten. Lesen Sie deren Datenrichtlinien und die PDFCheck-Datenschutzerklärung vor dem Senden sensibler Dokumente.

Häufig gestellte Fragen