PDFCheck MCP-server

Forbind via HTTP

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

Uden token (10 gratis tjek/dag)

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"
        }
    }
}

Erstat YOUR_API_TOKEN i din klientkonfiguration. Fjern Authorization-headeren for anonym adgang.

{
    "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"
            }
        }
    }
}

Kontrollér forbindelsen

Bed først din assistent om at kalde check_usage. Analysér derefter en PDF med en klient, som kan læse filen og Base64-kode den. En lokal filsti alene virker ikke med fjernadgang via HTTP.

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

Tilgængelige MCP-værktøjer

Disse MCP-værktøjer dækker metadataanalyse og kontohistorik. Komprimering, strukturvalidering, signering og andre browserværktøjer er ikke tilgængelige via disse metoder.

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"
        }
    }
}

Læs svaret

Værktøjsresultater indeholder JSON-tekst i result.content[0].text. Fortolk teksten for at læse success, data og remaining_checks; fejl kan også returnere isError.

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);

Brug den lokale bridge

Gem følgende fil som pdfcheck-mcp-server.mjs et vilkårligt sted på din maskine. Dette letvægtsscript forbinder dit AI-værktøj med PDFCheck API.

Det valgfrie lokale script kræver Node.js 18 eller nyere. Eksterne HTTP-forbindelser kræver hverken Node.js eller et downloadet script.

Gem scriptet i en separat mappe, installér dets afhængigheder dér, og brug den fulde scriptsti i din klientkonfiguration.

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

Erstat scriptstien med dens absolutte sti. Sæt PDFCHECK_API_TOKEN til dit kontotoken, eller udelad env for anonym analyse.

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

Når du er forbundet, kan du bruge disse prompts med en klient, der kan læse de ønskede filer. Ekstern analyze_pdf kræver file_base64 og filename; en lokal sti alene er ikke nok. Den lokale bro accepterer filePath.

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

Eksempler på brug

Når du er forbundet, kan du bruge disse prompts med en klient, der kan læse de ønskede filer. Ekstern analyze_pdf kræver file_base64 og filename; en lokal sti alene er ikke nok. Den lokale bro accepterer filePath.

Analyser en PDF

Analyser filen /Users/me/Documents/contract.pdf og fortæl mig, hvornår den blev oprettet, og hvilken software der blev brugt.

Undersøg softwareindikatorer

Undersøg felterne creator og producer i /Users/me/Downloads/report.pdf. Forklar softwareindikatorerne uden at behandle dem som bevis på AI-forfatterskab.

Batchanalyse

Analyser de PDF'er, jeg vælger fra min Downloads-mappe, én ad gangen. Sammenlign deres oprettelses- og ændringsdatoer, og forklar manglende eller uoverensstemmende metadata.

Tjek kvote

Hvor mange PDF-tjek har jeg tilbage i dag på PDFCheck?

Brug og grænser

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

Til metadataanalyse: uploads uden konto og med Free er begrænset til 50 MB. Med Pro og AI er grænsen 100 MB.

API-metadataanalyse bruger en begrænset, letvægtsfunktion. Detaljeret analyse af skrifttyper, billeder og farver springes over; metadata.basic.partial_analysis er true.

Metadata og softwareindikatorer beviser ikke forfatterskab, ægthed eller overholdelse af standarder.

Generer et API-token Valgfri

Hold tokens hemmelige. Brug en miljøvariabel, og tilbagekald ubrugte tokens på din konto.

Anonym adgang giver 10 metadataanalyser om dagen pr. IP-adresse. En gratis konto med API-token giver 100 tjek om dagen. Brug tokenet, når du analyserer, hvis du vil kunne hente resultatet via din konto senere.

Hvad er Model Context Protocol?

Model Context Protocol (MCP) er en åben standard, der gør det muligt for AI-assistenter at oprette forbindelse til eksterne værktøjer og datakilder. Tænk på det som et universelt stik, der lader din AI-assistent tale med tjenester som PDFCheck — direkte fra dit chatvindue.

Den eksterne HTTP-server modtager base64-kodet PDF-indhold fra din klient. Den valgfrie lokale bro læser en PDF fra din computer og uploader den til REST API'et. Begge returnerer metadataanalysen som JSON i content[0].text.

Vælg din forbindelsestype

Brug en klient, der understøtter ekstern HTTP-MCP med bearer-headere, eller en klient, der kan køre den lokale stdio-bro. Forbindelser, der kun bruger OAuth, understøttes ikke af denne opsætning.

PDF'en sendes til PDFCheck via HTTPS. Din MCP-klient eller AI-udbyder kan også håndtere filen eller værktøjsargumenterne, afhængigt af hvordan den er opbygget. Læs dens datapolitik og PDFCheck's privatlivspolitik, før du sender følsomme dokumenter.

Ofte stillede spørgsmål