@promptpartner/bexio-mcp-server 2.0.0

package/dist/ui-resources.js

@@ -0,0 +1,124 @@
+/**
+ * MCP Apps UI Resources Registration.
+ *
+ * Registers UI tools and resources for interactive invoice preview,
+ * contact card, and dashboard summary.
+ *
+ * Uses @modelcontextprotocol/ext-apps SDK for UI resource handling.
+ */
+import { registerAppTool, registerAppResource, RESOURCE_MIME_TYPE, } from "@modelcontextprotocol/ext-apps/server";
+import { z } from "zod";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { logger } from "./logger.js";
+// UI Resource URIs using ui:// scheme
+const INVOICE_PREVIEW_URI = "ui://bexio/invoice-preview.html";
+const CONTACT_CARD_URI = "ui://bexio/contact-card.html";
+const DASHBOARD_URI = "ui://bexio/dashboard.html";
+/**
+ * Register MCP Apps UI resources and tools.
+ *
+ * @param server - McpServer instance
+ * @param client - BexioClient for API calls
+ */
+export function registerUIResources(server, client) {
+    // Path to built UI files (vite outputs to dist/ui/ui/<name>/<name>.html)
+    const uiBasePath = path.join(import.meta.dirname, "../dist/ui/ui");
+    // ===== INVOICE PREVIEW =====
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    registerAppTool(server, "preview_invoice", {
+        title: "Preview Invoice",
+        description: "Display an interactive invoice preview with line items, totals, and status",
+        inputSchema: { invoice_id: z.number().int().describe("The invoice ID to preview") },
+        _meta: { ui: { resourceUri: INVOICE_PREVIEW_URI } },
+    }, async (args) => {
+        const invoiceId = args.invoice_id;
+        logger.debug(`preview_invoice called for invoice ${invoiceId}`);
+        const invoice = await client.getInvoice(invoiceId);
+        return {
+            content: [{ type: "text", text: JSON.stringify(invoice) }],
+        };
+    });
+    registerAppResource(server, INVOICE_PREVIEW_URI, INVOICE_PREVIEW_URI, { mimeType: RESOURCE_MIME_TYPE }, async () => {
+        const html = await fs.readFile(path.join(uiBasePath, "invoice-preview/invoice-preview.html"), "utf-8");
+        return {
+            contents: [{ uri: INVOICE_PREVIEW_URI, mimeType: RESOURCE_MIME_TYPE, text: html }],
+        };
+    });
+    // ===== CONTACT CARD =====
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    registerAppTool(server, "show_contact_card", {
+        title: "Show Contact Card",
+        description: "Display a formatted contact card with name, contact details, and address",
+        inputSchema: { contact_id: z.number().int().describe("The contact ID to display") },
+        _meta: { ui: { resourceUri: CONTACT_CARD_URI } },
+    }, async (args) => {
+        const contactId = args.contact_id;
+        logger.debug(`show_contact_card called for contact ${contactId}`);
+        const contact = await client.getContact(contactId);
+        return {
+            content: [{ type: "text", text: JSON.stringify(contact) }],
+        };
+    });
+    registerAppResource(server, CONTACT_CARD_URI, CONTACT_CARD_URI, { mimeType: RESOURCE_MIME_TYPE }, async () => {
+        const html = await fs.readFile(path.join(uiBasePath, "contact-card/contact-card.html"), "utf-8");
+        return {
+            contents: [{ uri: CONTACT_CARD_URI, mimeType: RESOURCE_MIME_TYPE, text: html }],
+        };
+    });
+    // ===== DASHBOARD =====
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    registerAppTool(server, "show_dashboard", {
+        title: "Show Dashboard",
+        description: "Display a summary dashboard with open invoices, overdue amounts, and recent contacts",
+        _meta: { ui: { resourceUri: DASHBOARD_URI } },
+    }, async () => {
+        logger.debug("show_dashboard called");
+        // Fetch dashboard data
+        const [openInvoices, overdueInvoices, contacts] = await Promise.all([
+            client.getOpenInvoices(),
+            client.getOverdueInvoices(),
+            client.listContacts({ limit: 5 }),
+        ]);
+        // Calculate totals
+        const openTotal = openInvoices.reduce((sum, inv) => {
+            const total = parseFloat(inv.total_gross || "0");
+            return sum + total;
+        }, 0);
+        const overdueTotal = overdueInvoices.reduce((sum, inv) => {
+            const total = parseFloat(inv.total_gross || "0");
+            return sum + total;
+        }, 0);
+        // Get currency from first invoice or default to CHF
+        const firstInvoice = openInvoices[0];
+        const currencyId = firstInvoice?.currency_id || 1;
+        const currency = currencyId === 1 ? "CHF" : currencyId === 2 ? "EUR" : "USD";
+        // Format recent contacts
+        const recentContacts = contacts.map((c) => {
+            const contact = c;
+            return {
+                id: contact.id,
+                name_1: contact.name_1,
+                name_2: contact.name_2 || null,
+            };
+        });
+        const dashboardData = {
+            open_invoices_count: openInvoices.length,
+            open_invoices_total: openTotal,
+            overdue_count: overdueInvoices.length,
+            overdue_total: overdueTotal,
+            recent_contacts: recentContacts,
+            currency,
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(dashboardData) }],
+        };
+    });
+    registerAppResource(server, DASHBOARD_URI, DASHBOARD_URI, { mimeType: RESOURCE_MIME_TYPE }, async () => {
+        const html = await fs.readFile(path.join(uiBasePath, "dashboard/dashboard.html"), "utf-8");
+        return {
+            contents: [{ uri: DASHBOARD_URI, mimeType: RESOURCE_MIME_TYPE, text: html }],
+        };
+    });
+    logger.info("Registered 3 UI tools and 3 UI resources (MCP Apps)");
+}

package/dist/vite.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/dist/vite.config.js

@@ -0,0 +1,46 @@
+import { defineConfig } from "vite";
+import { viteSingleFile } from "vite-plugin-singlefile";
+import { resolve } from "path";
+import { readdirSync, existsSync } from "fs";
+// Get list of UI entry points dynamically
+function getUiEntries() {
+    const uiDir = resolve(__dirname, "ui");
+    if (!existsSync(uiDir))
+        return {};
+    const entries = {};
+    const dirs = readdirSync(uiDir, { withFileTypes: true })
+        .filter(d => d.isDirectory());
+    for (const dir of dirs) {
+        const htmlPath = resolve(uiDir, dir.name, `${dir.name}.html`);
+        if (existsSync(htmlPath)) {
+            entries[dir.name] = htmlPath;
+        }
+    }
+    return entries;
+}
+export default defineConfig({
+    plugins: [
+        viteSingleFile({
+            // Disable recommended config to allow multiple entry points
+            useRecommendedBuildConfig: false,
+            removeViteModuleLoader: false,
+            deleteInlinedFiles: true,
+        }),
+    ],
+    root: ".",
+    base: "./",
+    build: {
+        outDir: "../dist/ui",
+        emptyOutDir: true,
+        // Inline all assets
+        assetsInlineLimit: () => true,
+        // Emit all CSS as single file for inlining
+        cssCodeSplit: false,
+        // Assets in root, not assets/ subdir
+        assetsDir: "",
+        rollupOptions: {
+            input: getUiEntries(),
+            // No inlineDynamicImports since we have multiple entries
+        },
+    },
+});

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@promptpartner/bexio-mcp-server",
+  "version": "2.0.0",
+  "description": "Model Context Protocol server for Bexio API integration",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "bexio-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && npm run build:ui",
+    "build:ui": "node -e \"const fs=require('fs'); if(fs.existsSync('ui')){const{execSync}=require('child_process');execSync('npx vite build',{stdio:'inherit'})}else{console.log('Skipping UI build - ui/ not found')}\"",
+    "dev": "tsx watch src/index.ts",
+    "dev:ui": "vite build --watch",
+    "start": "node dist/index.js",
+    "test": "vitest",
+    "type-check": "tsc --noEmit",
+    "clean": "node -e \"const fs=require('fs'); if(fs.existsSync('dist')){fs.rmSync('dist',{recursive:true}); console.log('Cleaned dist/')}\"",
+    "prebuild": "npm run clean",
+    "pack:mcpb": "npm run build && npm run copy:bundle && cd .. && mcpb pack",
+    "copy:bundle": "node -e \"const fs=require('fs'); const path=require('path'); function copyDir(src,dest){fs.mkdirSync(dest,{recursive:true});fs.readdirSync(src).forEach(f=>{const srcPath=path.join(src,f);const destPath=path.join(dest,f);fs.statSync(srcPath).isDirectory()?copyDir(srcPath,destPath):fs.copyFileSync(srcPath,destPath)})} const rootDist=path.join(__dirname,'..','dist'); if(fs.existsSync(rootDist))fs.rmSync(rootDist,{recursive:true}); copyDir('dist',rootDist); console.log('Copied dist/ to root for MCPB bundling')\"",
+    "validate:mcpb": "cd .. && mcpb validate manifest.json",
+    "prepublishOnly": "npm run build"
+  },
+  "author": {
+    "name": "Lukas Hertig",
+    "email": "lukas@promptpartner.ai"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/promptpartner/bexio-mcp-server.git"
+  },
+  "homepage": "https://github.com/promptpartner/bexio-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/promptpartner/bexio-mcp-server/issues"
+  },
+  "keywords": [
+    "mcp",
+    "bexio",
+    "api",
+    "typescript",
+    "model-context-protocol",
+    "claude",
+    "accounting",
+    "invoices",
+    "swiss"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "@modelcontextprotocol/ext-apps": "^1.0.1",
+    "axios": "^1.7.0",
+    "zod": "3.25.76",
+    "dotenv": "^16.3.0",
+    "fastify": "^4.28.0",
+    "@fastify/cors": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.8.0",
+    "typescript": "^5.5.0",
+    "tsx": "^4.0.0",
+    "vitest": "^2.0.0",
+    "vite": "^6.0.0",
+    "vite-plugin-singlefile": "^2.3.0",
+    "concurrently": "^8.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}