PDFCheck MCP serveris

Prisijungti per 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

Be rakto (10 nemokamų patikrų/dieną)

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

Kliento konfigūracijoje pakeiskite YOUR_API_TOKEN. Jei norite naudotis be paskyros, pašalinkite Authorization antraštę.

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

Patikrinti ryšį

Pirmiausia paprašykite asistento iškviesti check_usage. Tada analizuokite PDF naudodami klientą, kuris gali perskaityti failą ir užkoduoti jį base64 formatu. Nuotolinei HTTP prieigai vien vietinio failo kelio nepakanka.

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

Galimi MCP įrankiai

Šie MCP įrankiai skirti metaduomenų analizei ir paskyros istorijai. Glaudinimas, struktūros tikrinimas, pasirašymas ir kiti naršyklėje veikiantys įrankiai per šiuos metodus nepasiekiami.

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

Skaityti atsakymą

Įrankių rezultatuose JSON tekstas pateikiamas result.content[0].text. Išanalizuokite šį tekstą, kad perskaitytumėte success, data ir remaining_checks; nesėkmės atveju taip pat gali būti grąžintas 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);

Naudoti vietinį tarpininką

Išsaugokite šį failą kaip pdfcheck-mcp-server.mjs bet kurioje savo kompiuterio vietoje. Šis lengvas scenarijus sujungia jūsų AI įrankį su PDFCheck API.

Neprivalomam vietiniam scenarijui reikia Node.js 18 ar naujesnės versijos. Nuotoliniam HTTP ryšiui Node.js ir atsisiųsto scenarijaus nereikia.

Išsaugokite scenarijų atskirame kataloge, ten įdiekite jo priklausomybes ir kliento konfigūracijoje nurodykite visą scenarijaus kelią.

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

Nurodykite absoliutų scenarijaus kelią. PDFCHECK_API_TOKEN reikšmę pakeiskite savo paskyros žetonu arba praleiskite env, jei norite analizuoti be paskyros.

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

Prisijungę šias užklausas naudokite su klientu, galinčiu nuskaityti nurodytus failus. Nuotoliniam analyze_pdf reikia file_base64 ir filename – vien vietinio kelio nepakanka. Vietinis tiltas priima filePath.

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

Naudojimo pavyzdžiai

Prisijungę šias užklausas naudokite su klientu, galinčiu nuskaityti nurodytus failus. Nuotoliniam analyze_pdf reikia file_base64 ir filename – vien vietinio kelio nepakanka. Vietinis tiltas priima filePath.

Analizuoti PDF

Analizuok failą /Users/me/Documents/contract.pdf ir pasakyk, kada jis buvo sukurtas ir kokia programinė įranga buvo naudota.

Peržiūrėti programinės įrangos požymius

Peržiūrėk failo /Users/me/Downloads/report.pdf kūrėjo (Creator) ir generatoriaus (Producer) laukus. Paaiškink programinės įrangos požymius, nelaikydamas jų AI autorystės įrodymu.

Paketinė analizė

Po vieną išanalizuok PDF failus, kuriuos pasirinksiu iš aplanko „Atsisiuntimai“. Palygink jų nurodytas sukūrimo ir pakeitimo datas ir paaiškink, kurių metaduomenų trūksta ar kurie nesutampa.

Patikrinti kvotą

Kiek PDF patikrų šiandien man dar liko PDFCheck?

Naudojimas ir limitai

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

Metaduomenų analizei: be paskyros ir su Free planu galima įkelti iki 50 MB. Su Pro ir AI planais – iki 100 MB.

API metaduomenų analizė veikia ribotu, lengvuoju režimu. Išsami šriftų, vaizdų ir spalvų analizė praleidžiama; metadata.basic.partial_analysis reikšmė yra true.

Metaduomenys ir programinės įrangos požymiai neįrodo autorystės, autentiškumo ar atitikties standartams.

Sugeneruokite API raktą Neprivaloma

Žetonus laikykite paslaptyje. Naudokite aplinkos kintamąjį, o nenaudojamus žetonus atšaukite paskyroje.

Anoniminė prieiga leidžia atlikti 10 metaduomenų analizių per dieną iš vieno IP adreso. Nemokama paskyra su API raktu suteikia 100 patikrų per dieną. Jei norite rezultatą vėliau pasiekti per savo paskyrą, analizuodami naudokite raktą.

Kas yra modelio konteksto protokolas (MCP)?

Modelio konteksto protokolas (MCP) – tai atviras standartas, leidžiantis AI asistentams jungtis prie išorinių įrankių ir duomenų šaltinių. Tai tarsi universalus kištukas, per kurį jūsų AI asistentas gali bendrauti su tokiomis paslaugomis kaip PDFCheck – tiesiai iš pokalbio lango.

Nuotolinis HTTP serveris iš jūsų kliento gauna base64 koduotą PDF turinį. Neprivalomas vietinis tiltas nuskaito PDF jūsų kompiuteryje ir įkelia jį į REST API. Abiem atvejais metaduomenų analizė grąžinama JSON formatu lauke content[0].text.

Pasirinkite ryšio būdą

Naudokite klientą, kuris palaiko nuotolinį HTTP MCP su „Bearer“ antraštėmis, arba klientą, galintį paleisti vietinį stdio tiltą. Vien OAuth ryšiai šioje sąrankoje nepalaikomi.

PDF į PDFCheck siunčiamas per HTTPS. Priklausomai nuo veikimo principo, failą ar įrankio argumentus taip pat gali apdoroti jūsų MCP klientas arba AI paslaugų teikėjas. Prieš siųsdami jautrius dokumentus, susipažinkite su jo duomenų politika ir PDFCheck Privatumo politika.

Dažnai užduodami klausimai