aiquila-mcp 0.2.16 → 0.2.18

package/README.md

@@ -1,12 +1,12 @@
 # AIquila MCP Server
 
-MCP (Model Context Protocol) server that gives Claude full access to your Nextcloud instance — files, calendar, tasks, contacts, mail, maps, bookmarks, notes, and more. 126 tools across 20 categories.
+MCP (Model Context Protocol) server that gives any MCP client full access to your Nextcloud instance — files, calendar, tasks, contacts, mail, talk, maps, bookmarks, notes, and more. 198 tools across 31 categories.
 
 ## Quick Start
 
-### Claude Desktop (stdio)
+### Stdio (Claude Desktop, Claude Code, Cursor, etc.)
 
-Add to `~/.config/claude/claude_desktop_config.json`:
+Add to your MCP client configuration (example for Claude Desktop `~/.config/claude/claude_desktop_config.json`):
 
 ```json
 {
@@ -26,35 +26,58 @@ Add to `~/.config/claude/claude_desktop_config.json`:
 
 Generate an App Password in Nextcloud: **Settings → Security → Devices & sessions**.
 
-### Docker / Claude.ai / Claude Mobile (HTTP transport)
+### HTTP Transport (Docker, Claude.ai, remote clients)
 
-See the [Docker setup guide](https://github.com/elgorro/aiquila/blob/main/docs/mcp/setup.md#docker--claudeai-http-transport) for running AIquila as an HTTP server with OAuth for Claude.ai and Claude Mobile.
+See the [Docker setup guide](https://github.com/elgorro/aiquila/blob/main/docs/mcp/setup.md#docker--claudeai-http-transport) for running AIquila as an HTTP server with OAuth for remote MCP clients.
 
 ## What It Can Do
 
-| Category             |   Tools |
-| -------------------- | ------: |
-| Files                |      11 |
-| Status & Diagnostics |       3 |
-| App Management       |       6 |
-| Tags                 |       6 |
-| Security             |       2 |
-| Search               |       2 |
-| OCC Command          |       1 |
-| Shares               |       4 |
-| Tasks                |       6 |
-| Calendar             |       6 |
-| Notes                |       5 |
-| Contacts             |       6 |
-| Cookbook             |       6 |
-| Bookmarks            |      13 |
-| Mail                 |       8 |
-| Maps                 |      26 |
-| Assistant / AI       |       4 |
-| Users                |       4 |
-| Groups               |       4 |
-| AIquila              |       3 |
-| **Total**            | **126** |
+### Core (always available)
+
+| Category   | Tools |
+| ---------- | ----: |
+| Files      |    12 |
+| Status     |     3 |
+| Apps       |     6 |
+| Tags       |     6 |
+| Search     |     2 |
+| Users      |     4 |
+| Groups     |     4 |
+| Shares     |    10 |
+| Absence    |     3 |
+| Trash      |     3 |
+| Versions   |     2 |
+
+### AIquila app
+
+| Category   | Tools |
+| ---------- | ----: |
+| AIquila    |     3 |
+| Security   |     2 |
+| OCC        |     1 |
+| Projects   |     7 |
+
+### Optional Nextcloud apps
+
+| Category      | Tools |
+| ------------- | ----: |
+| Calendar      |     6 |
+| Tasks         |     6 |
+| Contacts      |     6 |
+| Notes         |     5 |
+| Mail          |     8 |
+| Deck          |    12 |
+| Cookbook       |     6 |
+| Maps          |    25 |
+| Photos        |    11 |
+| Talk          |    10 |
+| Circles       |     8 |
+| Bookmarks     |    13 |
+| Assistant     |     4 |
+| Translate     |     1 |
+| User Status   |     5 |
+| Notifications |     4 |
+| **Total**     | **198** |
 
 ## Configuration
 
@@ -64,7 +87,7 @@ See the [Docker setup guide](https://github.com/elgorro/aiquila/blob/main/docs/m
 | `NEXTCLOUD_USER`     | Yes      |                                               |
 | `NEXTCLOUD_PASSWORD` | Yes      | use an App Password                           |
 | `MCP_TRANSPORT`      | No       | `stdio` (default) or `http`                   |
-| `MCP_AUTH_ENABLED`   | No       | `true` to enable OAuth for Claude.ai          |
+| `MCP_AUTH_ENABLED`   | No       | `true` to enable OAuth for remote clients     |
 | `MCP_AUTH_SECRET`    | If auth  | `openssl rand -hex 32`                        |
 | `MCP_AUTH_ISSUER`    | If auth  | public HTTPS URL of this server               |
 | `LOG_LEVEL`          | No       | `trace`/`debug`/`info`/`warn`/`error`/`fatal` |
@@ -74,12 +97,12 @@ See the [Docker setup guide](https://github.com/elgorro/aiquila/blob/main/docs/m
 - Node.js 24+
 - A Nextcloud instance with an App Password
 
-Optional Nextcloud apps unlock additional tool categories: Tasks, Calendar, Contacts, Notes, Cookbook, Bookmarks, Mail, Maps.
+Optional Nextcloud apps unlock additional tool categories: Tasks, Calendar, Contacts, Notes, Cookbook, Deck, Bookmarks, Mail, Maps, Photos, Talk, Circles, and more.
 
 ## Documentation
 
 - [Setup Guide](https://github.com/elgorro/aiquila/blob/main/docs/mcp/setup.md) — detailed installation and configuration
-- [Tools Reference](https://github.com/elgorro/aiquila/blob/main/docs/mcp/README.md) — all 126 tools documented
+- [Tools Reference](https://github.com/elgorro/aiquila/blob/main/docs/mcp/README.md) — all 198 tools documented
 - [Architecture](https://github.com/elgorro/aiquila/blob/main/docs/dev/mcp-server-architecture.md) — design and internals
 - [Full Documentation](https://github.com/elgorro/aiquila/blob/main/docs/) — complete docs index
 

package/dist/auth/login.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { renderLoginForm } from './provider.js';
 import { logger } from '../logger.js';
 export function loginHandler(provider) {

package/dist/auth/provider.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { createHash, timingSafeEqual } from 'node:crypto';
 import { SignJWT, jwtVerify } from 'jose';
 import { InvalidGrantError } from '@modelcontextprotocol/sdk/server/auth/errors.js';

package/dist/auth/store.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { randomUUID } from 'node:crypto';
 import { readFileSync, writeFileSync, mkdirSync, renameSync, unlinkSync } from 'node:fs';
 import { join } from 'node:path';
@@ -92,12 +93,13 @@ export class ClientsStore {
     }
     /**
      * Creates a ClientsStore configured from environment variables:
-     *   MCP_CLIENT_ID  → pre-seeded static public PKCE client (for Claude.ai / Claude Desktop)
-     *   MCP_REGISTRATION_ENABLED=true      → enable dynamic POST /register
+     *   MCP_CLIENT_ID              → pre-seeded static public PKCE client (any MCP client)
+     *   MCP_CLIENT_REDIRECT_URIS   → comma-separated redirect URIs for the pre-seeded client
+     *   MCP_REGISTRATION_ENABLED=true → enable dynamic POST /register
      *
      * Note: no client_secret is stored — the SDK's clientAuth middleware requires the caller
      * to send client_secret whenever client.client_secret is set, which public OAuth clients
-     * (e.g. Claude.ai) never do. Security is enforced via PKCE instead.
+     * never do. Security is enforced via PKCE instead.
      */
     static fromEnv() {
         const preseeded = [];
@@ -109,7 +111,13 @@ export class ClientsStore {
                     .split(',')
                     .map((u) => u.trim())
                     .filter(Boolean)
-                : ['https://claude.ai/api/mcp/auth_callback'];
+                : [];
+            if (redirectUris.length === 0) {
+                logger.warn({ clientId: id }, '[config] MCP_CLIENT_ID is set but MCP_CLIENT_REDIRECT_URIS is empty — ' +
+                    'the pre-seeded client will not be able to complete the OAuth flow. ' +
+                    "Set MCP_CLIENT_REDIRECT_URIS to your client's callback URL, or enable " +
+                    'dynamic registration with MCP_REGISTRATION_ENABLED=true.');
+            }
             preseeded.push({
                 client_id: id,
                 client_id_issued_at: Math.floor(Date.now() / 1000),

package/dist/client/aiquila.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { getNextcloudConfig } from '../tools/types.js';
 import { logger } from '../logger.js';
 /**

package/dist/client/bookmarks.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { getNextcloudConfig } from '../tools/types.js';
 import { logger } from '../logger.js';
 /**

package/dist/client/caldav.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { logger } from '../logger.js';
 /**
  * Build a regex that matches an XML element with any namespace prefix.

package/dist/client/deck.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { getNextcloudConfig } from '../tools/types.js';
 import { logger } from '../logger.js';
 import { ApiError } from './aiquila.js';

package/dist/client/mail.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { getNextcloudConfig } from '../tools/types.js';
 import { logger } from '../logger.js';
 /**

package/dist/client/maps.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { getNextcloudConfig } from '../tools/types.js';
 import { logger } from '../logger.js';
 function buildUrl(base, endpoint, queryParams) {

package/dist/client/notes.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { getNextcloudConfig } from '../tools/types.js';
 import { logger } from '../logger.js';
 import { ApiError } from './aiquila.js';

package/dist/client/ocs.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { getNextcloudConfig } from '../tools/types.js';
 import { logger } from '../logger.js';
 /**

package/dist/client/webdav.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { createClient } from 'webdav';
 const NEXTCLOUD_URL = process.env.NEXTCLOUD_URL;
 const NEXTCLOUD_USER = process.env.NEXTCLOUD_USER;

package/dist/index.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// SPDX-License-Identifier: MIT
 import { startStdio } from './transports/stdio.js';
 import { startHttp } from './transports/http.js';
 import { logger } from './logger.js';
@@ -7,8 +8,8 @@ import { logger } from './logger.js';
  * Provides Model Context Protocol integration for Nextcloud
  *
  * Transport selection via MCP_TRANSPORT environment variable:
- *   - "stdio" (default): Standard input/output transport for Claude Desktop
- *   - "http": Streamable HTTP transport for Docker/network deployment
+ *   - "stdio" (default): Standard I/O transport for local MCP clients (e.g. Claude Desktop, Cursor)
+ *   - "http": Streamable HTTP transport for remote/network MCP clients
  */
 async function main() {
     const transport = process.env.MCP_TRANSPORT || 'stdio';

package/dist/logger.js

@@ -1,2 +1,3 @@
+// SPDX-License-Identifier: MIT
 import pino from 'pino';
 export const logger = pino({ level: process.env.LOG_LEVEL ?? 'info' }, process.stderr);

package/dist/server.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { createRequire } from 'node:module';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { logger } from './logger.js';

package/dist/tool-registry.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { fetchOCS } from './client/ocs.js';
 import { logger } from './logger.js';
 // System tools (always available)

package/dist/tools/apps/absence.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchOCS } from '../../client/ocs.js';
 import { getNextcloudConfig } from '../types.js';

package/dist/tools/apps/aiquila.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { executeOCC } from '../../client/aiquila.js';
 /**

package/dist/tools/apps/assistant.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchOCS } from '../../client/ocs.js';
 // NC TaskProcessing status codes

package/dist/tools/apps/bookmarks.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchBookmarksAPI } from '../../client/bookmarks.js';
 // ── Formatters ──────────────────────────────────────────────────────────────

package/dist/tools/apps/calendar.js

@@ -1,5 +1,7 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { decodeXmlEntities, fetchCalDAV, nsTagContent } from '../../client/caldav.js';
+import { escapeICalValue, unescapeICalValue } from '../dav-utils.js';
 import { getNextcloudConfig } from '../types.js';
 // ---------------------------------------------------------------------------
 // iCalendar helpers
@@ -7,20 +9,6 @@ import { getNextcloudConfig } from '../types.js';
 function unfoldICalLines(text) {
     return text.replace(/\r?\n[ \t]/g, '');
 }
-function escapeICalValue(value) {
-    return value
-        .replace(/\\/g, '\\\\')
-        .replace(/;/g, '\\;')
-        .replace(/,/g, '\\,')
-        .replace(/\n/g, '\\n');
-}
-function unescapeICalValue(value) {
-    return value
-        .replace(/\\n/g, '\n')
-        .replace(/\\,/g, ',')
-        .replace(/\\;/g, ';')
-        .replace(/\\\\/g, '\\');
-}
 function formatICalDate(icalDate) {
     if (icalDate.length === 8) {
         return `${icalDate.slice(0, 4)}-${icalDate.slice(4, 6)}-${icalDate.slice(6, 8)}`;

package/dist/tools/apps/circles.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchOCS } from '../../client/ocs.js';
 /**

package/dist/tools/apps/contacts.js

@@ -1,5 +1,7 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { decodeXmlEntities, fetchCalDAV, nsTagContent } from '../../client/caldav.js';
+import { escapeVCardValue, unescapeVCardValue } from '../dav-utils.js';
 import { getNextcloudConfig } from '../types.js';
 // ---------------------------------------------------------------------------
 // vCard helpers
@@ -7,20 +9,6 @@ import { getNextcloudConfig } from '../types.js';
 function unfoldVCardLines(text) {
     return text.replace(/\r?\n[ \t]/g, '');
 }
-function escapeVCardValue(value) {
-    return value
-        .replace(/\\/g, '\\\\')
-        .replace(/;/g, '\\;')
-        .replace(/,/g, '\\,')
-        .replace(/\n/g, '\\n');
-}
-function unescapeVCardValue(value) {
-    return value
-        .replace(/\\n/gi, '\n')
-        .replace(/\\,/g, ',')
-        .replace(/\\;/g, ';')
-        .replace(/\\\\/g, '\\');
-}
 /**
  * Extract TYPE parameter from a vCard property line.
  * Handles TYPE=WORK, TYPE="WORK", type=work, etc.

package/dist/tools/apps/cookbook.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { getWebDAVClient } from '../../client/webdav.js';
 /**

package/dist/tools/apps/deck.js

@@ -1,10 +1,16 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchDeckAPI, } from '../../client/deck.js';
-import { ApiError } from '../../client/aiquila.js';
+import { handleAppError } from '../error-utils.js';
 /**
  * Nextcloud Deck App Tools
  * Uses the Deck REST API v1.0 (/index.php/apps/deck/api/v1.0)
  */
+const deckStatusMap = {
+    404: 'Not found.',
+    403: 'Permission denied.',
+    400: (e) => `Bad request: ${e.responseBody}`,
+};
 function formatBoard(board) {
     const flags = [
         board.archived ? 'archived' : null,
@@ -62,31 +68,6 @@ function formatCardDetail(card) {
     lines.push(`Modified: ${new Date(card.lastModified * 1000).toISOString()}`);
     return lines.join('\n');
 }
-function handleError(error, context) {
-    if (error instanceof ApiError) {
-        if (error.statusCode === 404) {
-            return { content: [{ type: 'text', text: 'Not found.' }], isError: true };
-        }
-        if (error.statusCode === 403) {
-            return { content: [{ type: 'text', text: 'Permission denied.' }], isError: true };
-        }
-        if (error.statusCode === 400) {
-            return {
-                content: [{ type: 'text', text: `Bad request: ${error.responseBody}` }],
-                isError: true,
-            };
-        }
-    }
-    return {
-        content: [
-            {
-                type: 'text',
-                text: `${context}: ${error instanceof Error ? error.message : String(error)}`,
-            },
-        ],
-        isError: true,
-    };
-}
 export const listBoardsTool = {
     name: 'deck_list_boards',
     description: 'List all Deck boards. Returns id, title, owner, and label count for each board.',
@@ -107,7 +88,7 @@ export const listBoardsTool = {
             };
         }
         catch (error) {
-            return handleError(error, 'Error listing boards');
+            return handleAppError(error, 'Error listing boards', deckStatusMap);
         }
     },
 };
@@ -151,7 +132,7 @@ export const getBoardTool = {
             return { content: [{ type: 'text', text: lines.join('\n') }] };
         }
         catch (error) {
-            return handleError(error, 'Error getting board');
+            return handleAppError(error, 'Error getting board', deckStatusMap);
         }
     },
 };
@@ -176,7 +157,7 @@ export const createBoardTool = {
             };
         }
         catch (error) {
-            return handleError(error, 'Error creating board');
+            return handleAppError(error, 'Error creating board', deckStatusMap);
         }
     },
 };
@@ -216,7 +197,7 @@ export const listStacksTool = {
             };
         }
         catch (error) {
-            return handleError(error, 'Error listing stacks');
+            return handleAppError(error, 'Error listing stacks', deckStatusMap);
         }
     },
 };
@@ -239,7 +220,7 @@ export const createStackTool = {
             };
         }
         catch (error) {
-            return handleError(error, 'Error creating stack');
+            return handleAppError(error, 'Error creating stack', deckStatusMap);
         }
     },
 };
@@ -257,7 +238,7 @@ export const getCardTool = {
             return { content: [{ type: 'text', text: formatCardDetail(card) }] };
         }
         catch (error) {
-            return handleError(error, 'Error getting card');
+            return handleAppError(error, 'Error getting card', deckStatusMap);
         }
     },
 };
@@ -288,7 +269,7 @@ export const createCardTool = {
             };
         }
         catch (error) {
-            return handleError(error, 'Error creating card');
+            return handleAppError(error, 'Error creating card', deckStatusMap);
         }
     },
 };
@@ -325,7 +306,7 @@ export const updateCardTool = {
             };
         }
         catch (error) {
-            return handleError(error, 'Error updating card');
+            return handleAppError(error, 'Error updating card', deckStatusMap);
         }
     },
 };
@@ -359,7 +340,7 @@ export const moveCardTool = {
             };
         }
         catch (error) {
-            return handleError(error, 'Error moving card');
+            return handleAppError(error, 'Error moving card', deckStatusMap);
         }
     },
 };
@@ -386,7 +367,7 @@ export const archiveCardTool = {
             };
         }
         catch (error) {
-            return handleError(error, `Error ${args.archive ? 'archiving' : 'unarchiving'} card`);
+            return handleAppError(error, `Error ${args.archive ? 'archiving' : 'unarchiving'} card`, deckStatusMap);
         }
     },
 };
@@ -412,7 +393,7 @@ export const assignLabelTool = {
             };
         }
         catch (error) {
-            return handleError(error, 'Error assigning label');
+            return handleAppError(error, 'Error assigning label', deckStatusMap);
         }
     },
 };
@@ -438,7 +419,7 @@ export const assignUserTool = {
             };
         }
         catch (error) {
-            return handleError(error, 'Error assigning user');
+            return handleAppError(error, 'Error assigning user', deckStatusMap);
         }
     },
 };

package/dist/tools/apps/groups.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchOCS } from '../../client/ocs.js';
 /**

package/dist/tools/apps/mail.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchMailAPI } from '../../client/mail.js';
 import { fetchOCS } from '../../client/ocs.js';

package/dist/tools/apps/maps.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchMapsExternalAPI, fetchMapsAPI } from '../../client/maps.js';
 // ── Formatters ──────────────────────────────────────────────────────────────

package/dist/tools/apps/notes.js

@@ -1,10 +1,16 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchNotesAPI } from '../../client/notes.js';
-import { ApiError } from '../../client/aiquila.js';
+import { handleAppError } from '../error-utils.js';
 /**
  * Nextcloud Notes App Tools
  * Uses the Notes REST API v1 (/index.php/apps/notes/api/v1)
  */
+const notesStatusMap = {
+    404: 'Note not found.',
+    403: 'Note is read-only.',
+    412: 'Conflict: note was modified by someone else. Fetch the latest version and retry.',
+};
 function formatNote(note) {
     const date = new Date(note.modified * 1000).toISOString();
     const flags = [note.favorite ? 'favorite' : null, note.readonly ? 'readonly' : null]
@@ -15,36 +21,6 @@ function formatNote(note) {
         .join(' | ');
     return `[${note.id}] ${note.title}${meta ? ` (${meta})` : ''} — modified: ${date}`;
 }
-function handleError(error, context) {
-    if (error instanceof ApiError) {
-        if (error.statusCode === 404) {
-            return { content: [{ type: 'text', text: `Note not found.` }], isError: true };
-        }
-        if (error.statusCode === 403) {
-            return { content: [{ type: 'text', text: `Note is read-only.` }], isError: true };
-        }
-        if (error.statusCode === 412) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Conflict: note was modified by someone else. Fetch the latest version and retry.`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    }
-    return {
-        content: [
-            {
-                type: 'text',
-                text: `${context}: ${error instanceof Error ? error.message : String(error)}`,
-            },
-        ],
-        isError: true,
-    };
-}
 export const listNotesTool = {
     name: 'list_notes',
     description: 'List all notes in Nextcloud Notes. Returns id, title, category, favorite flag, and modification date.',
@@ -75,7 +51,7 @@ export const listNotesTool = {
             };
         }
         catch (error) {
-            return handleError(error, 'Error listing notes');
+            return handleAppError(error, 'Error listing notes', notesStatusMap);
         }
     },
 };
@@ -98,7 +74,7 @@ export const getNoteTool = {
             };
         }
         catch (error) {
-            return handleError(error, 'Error getting note');
+            return handleAppError(error, 'Error getting note', notesStatusMap);
         }
     },
 };
@@ -132,7 +108,7 @@ export const createNoteTool = {
             };
         }
         catch (error) {
-            return handleError(error, 'Error creating note');
+            return handleAppError(error, 'Error creating note', notesStatusMap);
         }
     },
 };
@@ -170,7 +146,7 @@ export const updateNoteTool = {
             };
         }
         catch (error) {
-            return handleError(error, 'Error updating note');
+            return handleAppError(error, 'Error updating note', notesStatusMap);
         }
     },
 };
@@ -193,7 +169,7 @@ export const deleteNoteTool = {
             };
         }
         catch (error) {
-            return handleError(error, 'Error deleting note');
+            return handleAppError(error, 'Error deleting note', notesStatusMap);
         }
     },
 };

package/dist/tools/apps/notifications.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchOCS } from '../../client/ocs.js';
 // ---------------------------------------------------------------------------

package/dist/tools/apps/photos.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchCalDAV, nsTagContent, decodeXmlEntities } from '../../client/caldav.js';
 import { getNextcloudConfig } from '../types.js';

package/dist/tools/apps/projects.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchAiquilaAPI } from '../../client/aiquila.js';
 function formatProject(p) {

package/dist/tools/apps/shares.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchOCS } from '../../client/ocs.js';
 const SHARE_TYPE_LABELS = {

package/dist/tools/apps/talk.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchOCS } from '../../client/ocs.js';
 /**

package/dist/tools/apps/tasks.js

@@ -1,5 +1,7 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { decodeXmlEntities, fetchCalDAV, nsTagContent } from '../../client/caldav.js';
+import { escapeICalValue } from '../dav-utils.js';
 import { getNextcloudConfig } from '../types.js';
 // ---------------------------------------------------------------------------
 // iCalendar helpers
@@ -11,16 +13,6 @@ import { getNextcloudConfig } from '../types.js';
 function unfoldICalLines(text) {
     return text.replace(/\r?\n[ \t]/g, '');
 }
-/**
- * Escape special characters in iCalendar text values per RFC 5545.
- */
-function escapeICalValue(value) {
-    return value
-        .replace(/\\/g, '\\\\')
-        .replace(/;/g, '\\;')
-        .replace(/,/g, '\\,')
-        .replace(/\n/g, '\\n');
-}
 /**
  * Format an iCalendar date string for human-readable display.
  * "20240115T103000Z" -> "2024-01-15 10:30"

package/dist/tools/apps/translate.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchOCS } from '../../client/ocs.js';
 // ---------------------------------------------------------------------------

package/dist/tools/apps/trash.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchCalDAV, decodeXmlEntities } from '../../client/caldav.js';
 import { getNextcloudConfig } from '../types.js';

package/dist/tools/apps/user-status.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchOCS } from '../../client/ocs.js';
 const STATUS_TYPES = ['online', 'away', 'dnd', 'invisible', 'offline'];

package/dist/tools/apps/users.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchOCS } from '../../client/ocs.js';
 /**

package/dist/tools/apps/versions.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchCalDAV } from '../../client/caldav.js';
 import { getNextcloudConfig } from '../types.js';

package/dist/tools/dav-utils.js

@@ -0,0 +1,30 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Shared DAV escape/unescape utilities for iCalendar and vCard values.
+ *
+ * iCalendar (RFC 5545) and vCard (RFC 6350) use nearly identical text escaping.
+ * The only difference: vCard allows uppercase \N for newlines, so unescape is
+ * case-insensitive for that sequence.
+ */
+export function escapeDavValue(value) {
+    return value
+        .replace(/\\/g, '\\\\')
+        .replace(/;/g, '\\;')
+        .replace(/,/g, '\\,')
+        .replace(/\n/g, '\\n');
+}
+export function unescapeDavValue(value, options) {
+    return value
+        .replace(options?.caseInsensitiveNewline ? /\\n/gi : /\\n/g, '\n')
+        .replace(/\\,/g, ',')
+        .replace(/\\;/g, ';')
+        .replace(/\\\\/g, '\\');
+}
+/** Escape for iCalendar (VEVENT, VTODO) properties. */
+export const escapeICalValue = escapeDavValue;
+/** Unescape iCalendar property values (case-sensitive \\n). */
+export const unescapeICalValue = (value) => unescapeDavValue(value);
+/** Escape for vCard properties. */
+export const escapeVCardValue = escapeDavValue;
+/** Unescape vCard property values (case-insensitive \\n per RFC 6350). */
+export const unescapeVCardValue = (value) => unescapeDavValue(value, { caseInsensitiveNewline: true });

package/dist/tools/error-utils.js

@@ -0,0 +1,30 @@
+// SPDX-License-Identifier: MIT
+import { ApiError } from '../client/aiquila.js';
+/**
+ * Shared error handler for app tool modules.
+ *
+ * @param error     The caught error
+ * @param context   Human-readable context prefixed to generic messages (e.g. "Error listing notes")
+ * @param statusMap Optional map of HTTP status codes to user-facing messages.
+ *                  When the error is an ApiError whose status matches a key, the corresponding
+ *                  message is returned. The message may be a string or a function receiving the
+ *                  ApiError for dynamic messages (e.g. including the response body).
+ */
+export function handleAppError(error, context, statusMap = {}) {
+    if (error instanceof ApiError) {
+        const entry = statusMap[error.statusCode];
+        if (entry !== undefined) {
+            const text = typeof entry === 'function' ? entry(error) : entry;
+            return { content: [{ type: 'text', text }], isError: true };
+        }
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `${context}: ${error instanceof Error ? error.message : String(error)}`,
+            },
+        ],
+        isError: true,
+    };
+}

package/dist/tools/system/apps.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchOCS } from '../../client/ocs.js';
 import { executeOCC } from '../../client/aiquila.js';

package/dist/tools/system/files.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { getWebDAVClient } from '../../client/webdav.js';
 import { fetchAiquilaAPI } from '../../client/aiquila.js';

package/dist/tools/system/occ-redact.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 /**
  * Redacts sensitive information from OCC command output.
  * Applied to stdout/stderr before returning results to the MCP client.

package/dist/tools/system/occ.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { executeOCC, formatOccError } from '../../client/aiquila.js';
 import { redactSensitiveOutput } from './occ-redact.js';

package/dist/tools/system/search.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchOCS } from '../../client/ocs.js';
 /**

package/dist/tools/system/security.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { executeOCC, formatOccError } from '../../client/aiquila.js';
 /**

package/dist/tools/system/status.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchOCS, fetchStatus } from '../../client/ocs.js';
 import { executeOCC, formatOccError } from '../../client/aiquila.js';

package/dist/tools/system/tags.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
 import { fetchCalDAV } from '../../client/caldav.js';
 import { getNextcloudConfig } from '../types.js';

package/dist/tools/types.js

@@ -1,4 +1,8 @@
+// SPDX-License-Identifier: MIT
 import { z } from 'zod';
+/**
+ * Shared type definitions for MCP tools
+ */
 /**
  * Zod schemas for common parameters
  */

package/dist/transports/http.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import https from 'node:https';
 import express from 'express';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
@@ -26,8 +27,8 @@ const TLS_CERT_ERROR_CODES = new Set([
 /**
  * Advisory TLS certificate check — purely informational, never crashes the server.
  *
- * Claude.ai and Claude mobile require a CA-trusted cert. If the issuer URL still
- * has a self-signed or untrusted cert at startup this is logged as a warning so
+ * Most MCP clients require a CA-trusted cert. If the issuer URL still has a
+ * self-signed or untrusted cert at startup this is logged as a warning so
  * operators know to fix it, but the MCP server continues running normally.
  *
  * Rationale: crashing or health-check-failing on a bad cert creates a deadlock on
@@ -62,8 +63,8 @@ async function checkIssuerTls(issuerUrl) {
             const code = err.code ?? '';
             if (TLS_CERT_ERROR_CODES.has(code)) {
                 logger.warn({ issuer: issuerUrl, code }, `[startup] TLS certificate not yet trusted (${code}). ` +
-                    `Claude.ai and Claude mobile require a CA-trusted certificate — self-signed certs ` +
-                    `will cause Claude to refuse the connection. ` +
+                    `Most MCP clients require a CA-trusted certificate — self-signed certs ` +
+                    `may cause clients to refuse the connection. ` +
                     `Use Let's Encrypt (via Traefik or Caddy with a real domain) or mount a CA-signed cert. ` +
                     `The MCP server will keep running; re-deploy once the cert is valid.`);
             }
@@ -149,8 +150,8 @@ export async function startHttp() {
     }
     // Stateless mode: create a new transport + server per request so each MCP
     // call is handled independently. This is required by the SDK for stateless
-    // operation and allows distributed clients (like Claude.ai) to connect from
-    // multiple IPs without needing a shared session.
+    // operation and allows distributed clients (like Claude.ai, Cursor, etc.) to
+    // connect from multiple IPs without needing a shared session.
     const handleMcpRequest = async (req, res) => {
         const mcpServer = await createServer();
         const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });

package/dist/transports/stdio.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { createServer } from '../server.js';
 import { logger } from '../logger.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "aiquila-mcp",
-  "version": "0.2.16",
-  "description": "AIquila - MCP server for Nextcloud integration with Claude AI",
+  "version": "0.2.18",
+  "description": "AIquila - MCP server for Nextcloud integration",
   "type": "module",
   "main": "dist/index.js",
   "bin": {