@promptpartner/bexio-mcp-server 2.0.2 → 2.0.4

package/README.md

@@ -1,25 +1,31 @@
 # @promptpartner/bexio-mcp-server
 
-Complete Swiss accounting integration for [Bexio](https://www.bexio.com/) with [Claude Desktop](https://claude.com/desktop). Manage invoices, contacts, projects, time tracking, and 200+ more tools through natural conversation.
+Complete Swiss accounting integration for [Bexio](https://www.bexio.com/) via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). Works with **Claude Desktop**, **n8n**, and any MCP-compatible client.
+
+Manage invoices, contacts, projects, time tracking, and 200+ more tools through AI conversation or workflow automation.
+
+## Compatibility
+
+| Client | Transport | Status |
+|--------|-----------|--------|
+| [Claude Desktop](https://claude.ai/download) | stdio | ✅ Fully supported |
+| [n8n](https://n8n.io/) | HTTP | ✅ Fully supported |
+| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | stdio | ✅ Fully supported |
+| Other MCP clients | stdio/HTTP | ✅ Should work |
 
 ## Quick Start
 
-### Option 1: MCPB Bundle (Recommended)
+### For Claude Desktop
+
+**Option A: MCPB Bundle (Easiest)**
 
 1. Download `bexio-mcp-server.mcpb` from [Releases](https://github.com/promptpartner/bexio-mcp-server/releases)
-2. Double-click to install in Claude Desktop
+2. Double-click to install
 3. Enter your Bexio API token when prompted
 
-### Option 2: npm
-
-```bash
-npx @promptpartner/bexio-mcp-server
-```
-
-Add to Claude Desktop config:
+**Option B: npm**
 
-**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
-**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+Add to `claude_desktop_config.json`:
 
 ```json
 {
@@ -35,37 +41,42 @@ Add to Claude Desktop config:
 }
 ```
 
-### Option 3: From Source
+Config location:
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+### For n8n and Other HTTP Clients
+
+Start the server in HTTP mode:
 
 ```bash
-git clone https://github.com/promptpartner/bexio-mcp-server
-cd bexio-mcp-server/src
-npm install
-npm run build
+BEXIO_API_TOKEN=your-token npx @promptpartner/bexio-mcp-server --mode http --port 8000
 ```
 
-Add to Claude Desktop config:
+The server exposes MCP over HTTP at `http://localhost:8000`. Configure your MCP client to connect to this endpoint.
 
-```json
-{
-  "mcpServers": {
-    "bexio": {
-      "command": "node",
-      "args": ["/path/to/bexio-mcp-server/src/dist/index.js"],
-      "env": {
-        "BEXIO_API_TOKEN": "your-token-here"
-      }
-    }
-  }
-}
+### For Other stdio Clients
+
+```bash
+BEXIO_API_TOKEN=your-token npx @promptpartner/bexio-mcp-server
+```
+
+Or build from source:
+
+```bash
+git clone https://github.com/promptpartner/bexio-mcp-server
+cd bexio-mcp-server/src
+npm install && npm run build
+BEXIO_API_TOKEN=your-token node dist/index.js
 ```
 
 ## Getting Your Bexio API Token
 
-1. Log in to [Bexio](https://office.bexio.com/)
-2. Go to **Settings** > **API Tokens**
-3. Click **Create Token**
-4. Copy the token and use it in your configuration
+1. Go to [developer.bexio.com](https://developer.bexio.com/)
+2. Log in with your regular Bexio account
+3. Navigate to **Personal Access Tokens**
+4. Click **Create New Token**
+5. Copy the token and use it in your configuration
 
 ## Features
 
@@ -81,7 +92,7 @@ This MCP server provides **221 tools** across all Bexio domains:
 - Quotes with accept/decline workflows
 - Orders with delivery management
 - Incoming payments tracking
-- Interactive invoice preview
+- Interactive invoice preview (Claude Desktop)
 
 ### Banking & Payments
 - Swiss QR-bill payment support (QR-IBAN)
@@ -115,14 +126,6 @@ This MCP server provides **221 tools** across all Bexio domains:
 - Absence tracking
 - Payroll documents
 
-## HTTP Mode
-
-For integration with n8n or other automation tools:
-
-```bash
-npx @promptpartner/bexio-mcp-server --mode http --port 8000
-```
-
 ## Environment Variables
 
 | Variable | Required | Default | Description |
@@ -130,10 +133,21 @@ npx @promptpartner/bexio-mcp-server --mode http --port 8000
 | `BEXIO_API_TOKEN` | Yes | - | Your Bexio API token |
 | `BEXIO_BASE_URL` | No | `https://api.bexio.com/2.0` | API endpoint URL |
 
+## Command Line Options
+
+```bash
+npx @promptpartner/bexio-mcp-server [options]
+
+Options:
+  --mode <stdio|http>  Transport mode (default: stdio)
+  --host <address>     HTTP host (default: 0.0.0.0)
+  --port <number>      HTTP port (default: 8000)
+```
+
 ## Troubleshooting
 
 ### "Invalid API token" error
-- Verify your token in Bexio Settings > API Tokens
+- Verify your token at [developer.bexio.com](https://developer.bexio.com/) > Personal Access Tokens
 - Ensure the token has not expired
 - Check that the token has the required permissions
 

package/dist/index.js

@@ -12,13 +12,17 @@
  * IMPORTANT: All logging goes to stderr via logger.ts.
  * stdout is reserved for MCP JSON-RPC protocol messages (stdio mode only).
  */
-import { config } from "dotenv";
 import { BexioMcpServer } from "./server.js";
 import { BexioClient } from "./bexio-client.js";
 import { logger } from "./logger.js";
 import { createHttpServer } from "./transports/http.js";
-// Load environment variables from .env file
-config();
+// Load environment variables from .env file (optional - for development)
+// In MCPB bundles, env vars are already set by Claude Desktop
+import("dotenv")
+    .then((dotenv) => dotenv.config())
+    .catch(() => {
+    // dotenv not available - that's fine for MCPB bundles
+});
 // Configuration from environment
 const BEXIO_API_TOKEN = process.env["BEXIO_API_TOKEN"];
 const BEXIO_BASE_URL = process.env["BEXIO_BASE_URL"] ?? "https://api.bexio.com/2.0";

package/dist/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptpartner/bexio-mcp-server",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "Model Context Protocol server for Bexio API integration",
   "main": "dist/index.js",
   "type": "module",
@@ -13,7 +13,8 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsc && npm run build:ui",
+    "build": "tsc && npm run build:ui && npm run postbuild",
+    "postbuild": "node -e \"require('fs').writeFileSync('dist/package.json', JSON.stringify({type:'module'}, null, 2)+'\\n'); console.log('Created dist/package.json')\"",
     "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",
@@ -22,7 +23,8 @@
     "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",
+    "bundle:mcpb": "node scripts/bundle-mcpb.js",
+    "pack:mcpb": "npm run build && npm run bundle:mcpb && 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"
@@ -52,22 +54,23 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.2",
+    "@fastify/cors": "^9.0.0",
     "@modelcontextprotocol/ext-apps": "^1.0.1",
+    "@modelcontextprotocol/sdk": "^1.25.2",
     "axios": "^1.7.0",
-    "zod": "3.25.76",
     "dotenv": "^16.3.0",
     "fastify": "^4.28.0",
-    "@fastify/cors": "^9.0.0"
+    "zod": "3.25.76"
   },
   "devDependencies": {
     "@types/node": "^20.8.0",
-    "typescript": "^5.5.0",
+    "concurrently": "^8.0.0",
+    "esbuild": "^0.27.2",
     "tsx": "^4.0.0",
-    "vitest": "^2.0.0",
+    "typescript": "^5.5.0",
     "vite": "^6.0.0",
     "vite-plugin-singlefile": "^2.3.0",
-    "concurrently": "^8.0.0"
+    "vitest": "^2.0.0"
   },
   "engines": {
     "node": ">=18.0.0"