@docdigitizer/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,97 @@
+# @docdigitizer/mcp-server
+
+MCP (Model Context Protocol) server for the DocDigitizer document processing API. Enables Claude Desktop and Claude Code to process PDFs and extract structured data directly.
+
+## Quick Start
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "docdigitizer": {
+      "command": "npx",
+      "args": ["-y", "@docdigitizer/mcp-server"],
+      "env": {
+        "DOCDIGITIZER_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add to your Claude Code MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "docdigitizer": {
+      "command": "npx",
+      "args": ["-y", "@docdigitizer/mcp-server"],
+      "env": {
+        "DOCDIGITIZER_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+### `health_check`
+
+Check if the DocDigitizer API is available.
+
+**Parameters:** None
+
+**Example prompt:** "Check if DocDigitizer is healthy"
+
+### `process_document`
+
+Upload and process a PDF document. Extracts structured data from invoices, receipts, contracts, CVs, IDs, and bank statements.
+
+**Parameters:**
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `file_path` | string | One of file_path or file_content | Absolute path to a local PDF file |
+| `file_content` | string | One of file_path or file_content | Base64-encoded PDF content |
+| `file_name` | string | No | Filename hint |
+| `document_id` | string (UUID) | No | Document UUID for tracking |
+| `context_id` | string (UUID) | No | Context UUID for grouping |
+| `pipeline` | string | No | Processing pipeline name |
+| `request_token` | string | No | Trace token (max 7 chars) |
+
+**Example prompts:**
+- "Process the invoice at C:/Documents/invoice.pdf"
+- "Extract data from the PDF at /home/user/receipt.pdf"
+
+## Configuration
+
+| Environment Variable | Required | Default | Description |
+|---------------------|----------|---------|-------------|
+| `DOCDIGITIZER_API_KEY` | Yes | — | Your DocDigitizer API key |
+| `DOCDIGITIZER_BASE_URL` | No | `https://apix.docdigitizer.com/sync` | API base URL |
+| `DOCDIGITIZER_TIMEOUT` | No | `300000` (5 min) | Request timeout in ms |
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+### Testing with MCP Inspector
+
+```bash
+DOCDIGITIZER_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js
+```
+
+## License
+
+MIT

package/dist/api-client.d.ts

@@ -0,0 +1,16 @@
+import type { Config } from "./config.js";
+import type { ProcessingResponse } from "./types.js";
+export declare class ApiClient {
+    private readonly config;
+    constructor(config: Config);
+    healthCheck(): Promise<string>;
+    processDocument(options: {
+        filePath?: string;
+        fileContent?: string;
+        fileName?: string;
+        id?: string;
+        contextId?: string;
+        pipelineIdentifier?: string;
+        requestToken?: string;
+    }): Promise<ProcessingResponse>;
+}

package/dist/api-client.js

@@ -0,0 +1,65 @@
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+import { randomUUID } from "node:crypto";
+import { parseResponse } from "./types.js";
+import { raiseForStatus } from "./errors.js";
+export class ApiClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async healthCheck() {
+        const response = await fetch(`${this.config.baseUrl}/`, {
+            method: "GET",
+            signal: AbortSignal.timeout(this.config.timeout),
+        });
+        if (response.status >= 400) {
+            raiseForStatus(response.status);
+        }
+        return response.text();
+    }
+    async processDocument(options) {
+        let fileBuffer;
+        let fileName;
+        if (options.filePath) {
+            fileBuffer = await readFile(options.filePath);
+            fileName = options.fileName ?? basename(options.filePath);
+        }
+        else if (options.fileContent) {
+            fileBuffer = Buffer.from(options.fileContent, "base64");
+            fileName = options.fileName ?? "document.pdf";
+        }
+        else {
+            throw new Error("Either filePath or fileContent (base64) is required");
+        }
+        const form = new FormData();
+        const blob = new Blob([fileBuffer.buffer.slice(fileBuffer.byteOffset, fileBuffer.byteOffset + fileBuffer.byteLength)], { type: "application/pdf" });
+        form.append("files", blob, fileName);
+        form.append("id", options.id ?? randomUUID());
+        form.append("contextID", options.contextId ?? randomUUID());
+        if (options.pipelineIdentifier) {
+            form.append("pipelineIdentifier", options.pipelineIdentifier);
+        }
+        if (options.requestToken) {
+            form.append("requestToken", options.requestToken);
+        }
+        const response = await fetch(`${this.config.baseUrl}/`, {
+            method: "POST",
+            headers: { "X-API-Key": this.config.apiKey },
+            body: form,
+            signal: AbortSignal.timeout(this.config.timeout),
+        });
+        let body = {};
+        try {
+            body = (await response.json());
+        }
+        catch {
+            // Non-JSON response
+        }
+        if (response.status >= 400) {
+            raiseForStatus(response.status, (body.traceId ?? body.TraceId) || undefined, (body.messages ?? body.Messages) || undefined, (body.timers ?? body.Timers) || undefined);
+        }
+        return parseResponse(body);
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+export interface Config {
+    apiKey: string;
+    baseUrl: string;
+    timeout: number;
+}
+export declare function loadConfig(): Config;

package/dist/config.js

@@ -0,0 +1,14 @@
+const DEFAULT_BASE_URL = "https://apix.docdigitizer.com/sync";
+const DEFAULT_TIMEOUT = 300_000; // 5 minutes
+export function loadConfig() {
+    const apiKey = process.env.DOCDIGITIZER_API_KEY ?? "";
+    if (!apiKey) {
+        throw new Error("DOCDIGITIZER_API_KEY is required. Set it as an environment variable.");
+    }
+    const baseUrl = (process.env.DOCDIGITIZER_BASE_URL ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    const timeout = process.env.DOCDIGITIZER_TIMEOUT
+        ? parseInt(process.env.DOCDIGITIZER_TIMEOUT, 10)
+        : DEFAULT_TIMEOUT;
+    return { apiKey, baseUrl, timeout };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAMA,MAAM,gBAAgB,GAAG,oCAAoC,CAAC;AAC9D,MAAM,eAAe,GAAG,OAAO,CAAC,CAAC,YAAY;AAE7C,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC;IACtD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,CACd,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,gBAAgB,CACtD,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEtB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB;QAC9C,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAChD,CAAC,CAAC,eAAe,CAAC;IAEpB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,26 @@
+export declare class DocDigitizerError extends Error {
+    readonly statusCode?: number | undefined;
+    readonly traceId?: string | undefined;
+    readonly messages?: string[] | undefined;
+    readonly timers?: Record<string, unknown> | undefined;
+    constructor(message: string, statusCode?: number | undefined, traceId?: string | undefined, messages?: string[] | undefined, timers?: Record<string, unknown> | undefined);
+}
+export declare class AuthenticationError extends DocDigitizerError {
+    constructor(...args: ConstructorParameters<typeof DocDigitizerError>);
+}
+export declare class ValidationError extends DocDigitizerError {
+    constructor(...args: ConstructorParameters<typeof DocDigitizerError>);
+}
+export declare class RateLimitError extends DocDigitizerError {
+    constructor(...args: ConstructorParameters<typeof DocDigitizerError>);
+}
+export declare class ServerError extends DocDigitizerError {
+    constructor(...args: ConstructorParameters<typeof DocDigitizerError>);
+}
+export declare class ServiceUnavailableError extends DocDigitizerError {
+    constructor(...args: ConstructorParameters<typeof DocDigitizerError>);
+}
+export declare class TimeoutError extends DocDigitizerError {
+    constructor(...args: ConstructorParameters<typeof DocDigitizerError>);
+}
+export declare function raiseForStatus(statusCode: number, traceId?: string, messages?: string[], timers?: Record<string, unknown>): never;

package/dist/errors.js

@@ -0,0 +1,64 @@
+export class DocDigitizerError extends Error {
+    statusCode;
+    traceId;
+    messages;
+    timers;
+    constructor(message, statusCode, traceId, messages, timers) {
+        super(message);
+        this.statusCode = statusCode;
+        this.traceId = traceId;
+        this.messages = messages;
+        this.timers = timers;
+        this.name = "DocDigitizerError";
+    }
+}
+export class AuthenticationError extends DocDigitizerError {
+    constructor(...args) {
+        super(...args);
+        this.name = "AuthenticationError";
+    }
+}
+export class ValidationError extends DocDigitizerError {
+    constructor(...args) {
+        super(...args);
+        this.name = "ValidationError";
+    }
+}
+export class RateLimitError extends DocDigitizerError {
+    constructor(...args) {
+        super(...args);
+        this.name = "RateLimitError";
+    }
+}
+export class ServerError extends DocDigitizerError {
+    constructor(...args) {
+        super(...args);
+        this.name = "ServerError";
+    }
+}
+export class ServiceUnavailableError extends DocDigitizerError {
+    constructor(...args) {
+        super(...args);
+        this.name = "ServiceUnavailableError";
+    }
+}
+export class TimeoutError extends DocDigitizerError {
+    constructor(...args) {
+        super(...args);
+        this.name = "TimeoutError";
+    }
+}
+const STATUS_CODE_MAP = {
+    400: ValidationError,
+    401: AuthenticationError,
+    429: RateLimitError,
+    500: ServerError,
+    503: ServiceUnavailableError,
+    504: TimeoutError,
+};
+export function raiseForStatus(statusCode, traceId, messages, timers) {
+    const ErrorClass = STATUS_CODE_MAP[statusCode] ?? DocDigitizerError;
+    const msg = messages?.join("; ") ?? `HTTP ${statusCode}`;
+    throw new ErrorClass(msg, statusCode, traceId, messages, timers);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAGxB;IACA;IACA;IACA;IALlB,YACE,OAAe,EACC,UAAmB,EACnB,OAAgB,EAChB,QAAmB,EACnB,MAAgC;QAEhD,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,eAAU,GAAV,UAAU,CAAS;QACnB,YAAO,GAAP,OAAO,CAAS;QAChB,aAAQ,GAAR,QAAQ,CAAW;QACnB,WAAM,GAAN,MAAM,CAA0B;QAGhD,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACxD,YAAY,GAAG,IAAqD;QAClE,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,iBAAiB;IACpD,YAAY,GAAG,IAAqD;QAClE,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,iBAAiB;IACnD,YAAY,GAAG,IAAqD;QAClE,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,iBAAiB;IAChD,YAAY,GAAG,IAAqD;QAClE,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,iBAAiB;IAC5D,YAAY,GAAG,IAAqD;QAClE,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,iBAAiB;IACjD,YAAY,GAAG,IAAqD;QAClE,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,eAAe,GAA6C;IAChE,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,YAAY;CAClB,CAAC;AAEF,MAAM,UAAU,cAAc,CAC5B,UAAkB,EAClB,OAAgB,EAChB,QAAmB,EACnB,MAAgC;IAEhC,MAAM,UAAU,GAAG,eAAe,CAAC,UAAU,CAAC,IAAI,iBAAiB,CAAC;IACpE,MAAM,GAAG,GAAG,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,UAAU,EAAE,CAAC;IACzD,MAAM,IAAI,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AACnE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("DocDigitizer MCP server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;AAC5D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,131 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { loadConfig } from "./config.js";
+import { ApiClient } from "./api-client.js";
+import { DocDigitizerError } from "./errors.js";
+export function createServer() {
+    const config = loadConfig();
+    const client = new ApiClient(config);
+    const server = new McpServer({
+        name: "docdigitizer",
+        version: "0.1.0",
+    });
+    server.tool("health_check", "Check if the DocDigitizer API is available and responsive", {}, async () => {
+        try {
+            const text = await client.healthCheck();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ status: "ok", message: text }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    server.tool("process_document", "Upload and process a PDF document through DocDigitizer. " +
+        "Extracts structured data from invoices, receipts, contracts, CVs, IDs, and bank statements. " +
+        "Provide either file_path (local path) or file_content (base64-encoded PDF).", {
+        file_path: z
+            .string()
+            .optional()
+            .describe("Absolute path to a local PDF file"),
+        file_content: z
+            .string()
+            .optional()
+            .describe("Base64-encoded PDF content"),
+        file_name: z
+            .string()
+            .optional()
+            .describe("Filename hint (defaults to basename of file_path or 'document.pdf')"),
+        document_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe("Document UUID for tracking (auto-generated if omitted)"),
+        context_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe("Context UUID for grouping related documents (auto-generated if omitted)"),
+        pipeline: z
+            .string()
+            .optional()
+            .describe("Processing pipeline (e.g. 'MainPipelineWithOCR')"),
+        request_token: z
+            .string()
+            .optional()
+            .describe("Trace token (max 7 chars, auto-generated if omitted)"),
+    }, async (params) => {
+        if (!params.file_path && !params.file_content) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "ValidationError",
+                            message: "Either file_path or file_content (base64) is required",
+                        }),
+                    },
+                ],
+            };
+        }
+        try {
+            const result = await client.processDocument({
+                filePath: params.file_path,
+                fileContent: params.file_content,
+                fileName: params.file_name,
+                id: params.document_id,
+                contextId: params.context_id,
+                pipelineIdentifier: params.pipeline,
+                requestToken: params.request_token,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    return server;
+}
+function errorResult(error) {
+    if (error instanceof DocDigitizerError) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: error.name,
+                        message: error.message,
+                        statusCode: error.statusCode,
+                        traceId: error.traceId,
+                        messages: error.messages,
+                    }),
+                },
+            ],
+        };
+    }
+    const msg = error instanceof Error ? error.message : String(error);
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({ error: "Error", message: msg }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+export interface PageRange {
+    start: number;
+    end: number;
+}
+export interface Extraction {
+    documentType: string;
+    confidence: number;
+    countryCode: string;
+    pages: number[];
+    pageRange?: PageRange;
+    extraction: Record<string, unknown>;
+    schema?: string;
+    modelSource?: string;
+}
+export interface ProcessingOutput {
+    extractions: Extraction[];
+}
+export interface ProcessingResponse {
+    state: string;
+    traceId: string;
+    pipeline?: string;
+    numPages?: number;
+    output?: ProcessingOutput;
+    timers?: Record<string, unknown>;
+    messages?: string[];
+}
+export declare function parseResponse(data: Record<string, unknown>): ProcessingResponse;

package/dist/types.js

@@ -0,0 +1,49 @@
+function get(data, camel, pascal, fallback) {
+    if (camel in data)
+        return data[camel];
+    if (pascal in data)
+        return data[pascal];
+    return fallback;
+}
+function parseExtraction(raw) {
+    const pages = (raw.pages ?? []);
+    const pageRangeRaw = raw.pageRange;
+    let pageRange;
+    if (pageRangeRaw && typeof pageRangeRaw === "object") {
+        pageRange = { start: pageRangeRaw.start, end: pageRangeRaw.end };
+    }
+    else if (pages.length > 0) {
+        pageRange = { start: Math.min(...pages), end: Math.max(...pages) };
+    }
+    return {
+        documentType: get(raw, "docType", "documentType", ""),
+        confidence: (raw.confidence ?? 0),
+        countryCode: get(raw, "country", "countryCode", ""),
+        pages,
+        pageRange,
+        extraction: (raw.extraction ?? {}),
+        schema: raw.schema,
+        modelSource: raw.modelSource,
+    };
+}
+function parseOutput(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const obj = raw;
+    const rawExtractions = (obj.extractions ?? []);
+    return {
+        extractions: rawExtractions.map(parseExtraction),
+    };
+}
+export function parseResponse(data) {
+    return {
+        state: get(data, "stateText", "StateText", ""),
+        traceId: get(data, "traceId", "TraceId", ""),
+        pipeline: get(data, "pipeline", "Pipeline"),
+        numPages: get(data, "numberPages", "NumberPages"),
+        output: parseOutput(get(data, "output", "Output")),
+        timers: get(data, "timers", "Timers"),
+        messages: get(data, "messages", "Messages"),
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA8BA,SAAS,GAAG,CACV,IAA6B,EAC7B,KAAa,EACb,MAAc,EACd,QAAkB;IAElB,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,eAAe,CAAC,GAA4B;IACnD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAa,CAAC;IAC5C,MAAM,YAAY,GAAG,GAAG,CAAC,SAEZ,CAAC;IACd,IAAI,SAAgC,CAAC;IAErC,IAAI,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrD,SAAS,GAAG,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,YAAY,CAAC,GAAG,EAAE,CAAC;IACnE,CAAC;SAAM,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,SAAS,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC;IACrE,CAAC;IAED,OAAO;QACL,YAAY,EAAG,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,CAAY;QACjE,UAAU,EAAE,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,CAAW;QAC3C,WAAW,EAAG,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,CAAY;QAC/D,KAAK;QACL,SAAS;QACT,UAAU,EAAE,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAA4B;QAC7D,MAAM,EAAE,GAAG,CAAC,MAA4B;QACxC,WAAW,EAAE,GAAG,CAAC,WAAiC;KACnD,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,GAAY;IAEZ,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAA8B,CAAC;IAC5E,OAAO;QACL,WAAW,EAAE,cAAc,CAAC,GAAG,CAAC,eAAe,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,IAA6B;IAE7B,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,CAAW;QACxD,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,CAAW;QACtD,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAuB;QACjE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,aAAa,CAAuB;QACvE,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAClD,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAEvB;QACb,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAyB;KACpE,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@docdigitizer/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for DocDigitizer document processing API",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "docdigitizer-mcp": "./dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^18.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^3.0.0",
+    "yaml": "^2.7.0"
+  },
+  "author": {
+    "name": "DocDigitizer",
+    "email": "support@docdigitizer.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DocDigitizer/dd-v3-integrations",
+    "directory": "integrations/mcp-server"
+  },
+  "keywords": [
+    "docdigitizer",
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ocr",
+    "document-processing",
+    "pdf"
+  ]
+}