aidocx-mcp-server 0.1.0

package/build/api-client.d.ts

@@ -0,0 +1,11 @@
+import type { AiDocxConfig } from "./config.js";
+export declare class AiDocxClient {
+    private config;
+    constructor(config: AiDocxConfig);
+    private get headers();
+    get appUrl(): string;
+    private url;
+    get<T = any>(path: string, params?: Record<string, string>): Promise<T>;
+    post<T = any>(path: string, body: Record<string, any>): Promise<T>;
+    delete<T = any>(path: string): Promise<T>;
+}

package/build/api-client.js

@@ -0,0 +1,57 @@
+export class AiDocxClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    get headers() {
+        return {
+            "Content-Type": "application/json",
+            "X-API-Key": this.config.apiKey,
+            "X-API-Secret": this.config.apiSecret,
+        };
+    }
+    get appUrl() {
+        return this.config.appUrl;
+    }
+    url(path) {
+        return `${this.config.apiUrl}/api${path}`;
+    }
+    async get(path, params) {
+        const url = new URL(this.url(path));
+        if (params) {
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined && v !== "")
+                    url.searchParams.set(k, v);
+            }
+        }
+        const res = await fetch(url.toString(), { headers: this.headers });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`API ${res.status}: ${body}`);
+        }
+        return res.json();
+    }
+    async post(path, body) {
+        const res = await fetch(this.url(path), {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`API ${res.status}: ${text}`);
+        }
+        return res.json();
+    }
+    async delete(path) {
+        const res = await fetch(this.url(path), {
+            method: "DELETE",
+            headers: this.headers,
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`API ${res.status}: ${text}`);
+        }
+        return res.json();
+    }
+}

package/build/config.d.ts

@@ -0,0 +1,7 @@
+export interface AiDocxConfig {
+    apiKey: string;
+    apiSecret: string;
+    apiUrl: string;
+    appUrl: string;
+}
+export declare function loadConfig(): AiDocxConfig;

package/build/config.js

@@ -0,0 +1,12 @@
+export function loadConfig() {
+    const apiKey = process.env.AIDOCX_API_KEY;
+    const apiSecret = process.env.AIDOCX_API_SECRET;
+    const apiUrl = process.env.AIDOCX_API_URL || "https://api.aidocx.ai";
+    const appUrl = process.env.AIDOCX_APP_URL || "https://app.aidocx.ai";
+    if (!apiKey || !apiSecret) {
+        console.error("[AiDocX MCP] Missing AIDOCX_API_KEY or AIDOCX_API_SECRET.\n" +
+            "Generate an API key at https://app.aidocx.ai/settings → API Keys.");
+        process.exit(1);
+    }
+    return { apiKey, apiSecret, apiUrl, appUrl };
+}

package/build/index.d.ts

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

package/build/index.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig } from "./config.js";
+import { AiDocxClient } from "./api-client.js";
+import { register as registerCreateContractHtml } from "./tools/create-contract-html.js";
+import { register as registerUploadContract } from "./tools/upload-contract.js";
+import { register as registerListContracts } from "./tools/list-contracts.js";
+import { register as registerGetContract } from "./tools/get-contract.js";
+import { register as registerListFolders } from "./tools/list-folders.js";
+import { register as registerCreateFolder } from "./tools/create-folder.js";
+async function main() {
+    const config = loadConfig();
+    const client = new AiDocxClient(config);
+    const server = new McpServer({
+        name: "aidocx",
+        version: "0.1.0",
+    });
+    registerCreateContractHtml(server, client);
+    registerUploadContract(server, client);
+    registerListContracts(server, client);
+    registerGetContract(server, client);
+    registerListFolders(server, client);
+    registerCreateFolder(server, client);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[AiDocX MCP] Server running on stdio");
+}
+main().catch((error) => {
+    console.error("[AiDocX MCP] Fatal:", error);
+    process.exit(1);
+});

package/build/tools/create-contract-html.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AiDocxClient } from "../api-client.js";
+export declare function register(server: McpServer, client: AiDocxClient): void;

package/build/tools/create-contract-html.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+export function register(server, client) {
+    // @ts-expect-error -- MCP SDK generic recursion with zod v3.25+ optional()
+    server.registerTool("create_contract_from_html", {
+        description: "Create a new contract in AiDocX from HTML content. The HTML is rendered to a PDF " +
+            "using Noto Sans KR font and Tailwind CSS, then stored in document management. " +
+            "A4 page size with 2cm margins.\n\n" +
+            "IMPORTANT: Before calling this tool, you MUST confirm the following with the user:\n" +
+            "1. Contract type (e.g., service agreement, employment contract, NDA)\n" +
+            "2. Parties involved (company names, representative names, roles)\n" +
+            "3. Key terms (duration, amount, payment schedule)\n" +
+            "4. Number of signers and their names/roles\n" +
+            "5. Any special clauses or conditions\n\n" +
+            "Generate professional, legally-structured HTML with proper headings, articles, " +
+            "and signature blocks for each signer at the bottom. " +
+            "Do NOT include <html>/<head>/<body> wrapper — only the inner content.",
+        inputSchema: {
+            name: z.string(),
+            html: z.string(),
+            folderId: z.string().optional(),
+        },
+    }, async ({ name, html, folderId }) => {
+        try {
+            const result = await client.post("/contracts/create-from-html", { name, html, folderId });
+            const signingUrl = `${client.appUrl}/contracts/${result.id}/signing`;
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            contractId: result.id,
+                            name: result.name,
+                            fileSize: result.fileSize,
+                            message: `Contract "${result.name}" created successfully.`,
+                            signingWorkspaceUrl: signingUrl,
+                            nextStep: "Open the signing workspace URL to place signature fields and send to signers.",
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/build/tools/create-folder.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AiDocxClient } from "../api-client.js";
+export declare function register(server: McpServer, client: AiDocxClient): void;

package/build/tools/create-folder.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+const inputSchema = {
+    name: z.string().describe("Folder name"),
+    parentId: z.string().optional().describe("Parent folder ID. Omit for root level."),
+};
+export function register(server, client) {
+    server.registerTool("create_folder", {
+        description: "Create a new folder in AiDocX document management.",
+        inputSchema,
+    }, async ({ name, parentId }) => {
+        try {
+            const result = await client.post("/contracts/folders", { name, parentId });
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            folderId: result.id,
+                            name: result.name,
+                            message: `Folder "${result.name}" created.`,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/build/tools/get-contract.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AiDocxClient } from "../api-client.js";
+export declare function register(server: McpServer, client: AiDocxClient): void;

package/build/tools/get-contract.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+const inputSchema = {
+    id: z.string().describe("Contract ID"),
+};
+export function register(server, client) {
+    server.registerTool("get_contract", {
+        description: "Get details of a specific contract in AiDocX. Returns name, type, size, and text extract.",
+        inputSchema,
+    }, async ({ id }) => {
+        try {
+            const result = await client.get(`/contracts/${id}`);
+            const contract = result.contract || result;
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            id: contract.id, name: contract.name,
+                            fileName: contract.fileName, fileType: contract.fileType,
+                            fileSize: contract.fileSize, contentType: contract.contentType,
+                            folderId: contract.folderId, labels: contract.labels,
+                            textExtract: contract.textExtract,
+                            createdAt: contract.createdAt, updatedAt: contract.updatedAt,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/build/tools/list-contracts.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AiDocxClient } from "../api-client.js";
+export declare function register(server: McpServer, client: AiDocxClient): void;

package/build/tools/list-contracts.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+const inputSchema = {
+    folderId: z.string().optional().describe("Folder ID to list. Omit for root folder."),
+};
+export function register(server, client) {
+    server.registerTool("list_contracts", {
+        description: "List contracts in the user's AiDocX document management.",
+        inputSchema,
+    }, async ({ folderId }) => {
+        try {
+            const params = {};
+            if (folderId)
+                params.folderId = folderId;
+            const result = await client.get("/contracts", params);
+            const contracts = result.contracts || result;
+            const summary = Array.isArray(contracts)
+                ? contracts.map((c) => ({
+                    id: c.id, name: c.name, fileType: c.fileType,
+                    fileSize: c.fileSize, contentType: c.contentType,
+                    createdAt: c.createdAt, updatedAt: c.updatedAt,
+                }))
+                : contracts;
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            count: Array.isArray(summary) ? summary.length : 0,
+                            contracts: summary,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/build/tools/list-folders.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AiDocxClient } from "../api-client.js";
+export declare function register(server: McpServer, client: AiDocxClient): void;

package/build/tools/list-folders.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+const inputSchema = {
+    parentId: z.string().optional().describe("Parent folder ID. Omit for root-level folders."),
+};
+export function register(server, client) {
+    server.registerTool("list_folders", {
+        description: "List folders in the user's AiDocX document management.",
+        inputSchema,
+    }, async ({ parentId }) => {
+        try {
+            const params = {};
+            if (parentId)
+                params.parentId = parentId;
+            const result = await client.get("/contracts/folders", params);
+            const folders = result.folders || result;
+            const summary = Array.isArray(folders)
+                ? folders.map((f) => ({
+                    id: f.id, name: f.name, parentId: f.parentId, createdAt: f.createdAt,
+                }))
+                : folders;
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            count: Array.isArray(summary) ? summary.length : 0,
+                            folders: summary,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/build/tools/upload-contract.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AiDocxClient } from "../api-client.js";
+export declare function register(server: McpServer, client: AiDocxClient): void;

package/build/tools/upload-contract.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+const inputSchema = {
+    fileName: z.string().describe("File name with extension (e.g., 'contract.pdf')"),
+    fileBase64: z.string().describe("Base64-encoded file content (max 50MB)"),
+    fileType: z.string().describe("MIME type (e.g., 'application/pdf')"),
+    folderId: z.string().optional().describe("Target folder ID. Omit for root."),
+};
+export function register(server, client) {
+    server.registerTool("upload_contract", {
+        description: "Upload a PDF or Office document (DOC, DOCX, HWP, XLS, XLSX, PPT, PPTX) to AiDocX. " +
+            "Office files are auto-converted to PDF.",
+        inputSchema,
+    }, async ({ fileName, fileBase64, fileType, folderId }) => {
+        try {
+            const result = await client.post("/contracts/upload", {
+                file: fileBase64, fileName, fileType, folderId,
+            });
+            const signingUrl = `${client.appUrl}/contracts/${result.id}/signing`;
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            contractId: result.id,
+                            name: result.name,
+                            fileSize: result.fileSize,
+                            message: `File "${result.name}" uploaded successfully.`,
+                            signingWorkspaceUrl: signingUrl,
+                            nextStep: "Open the signing workspace URL to place signature fields and send to signers.",
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "aidocx-mcp-server",
+  "version": "0.1.0",
+  "description": "AiDocX MCP Server - Upload and manage contracts from Claude Desktop and other MCP clients",
+  "type": "module",
+  "bin": {
+    "aidocx-mcp": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "files": [
+    "build"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.5.0",
+    "tsx": "^4.19.0"
+  }
+}