dav-mcp 3.0.5 → 3.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dav-mcp",
-  "version": "3.0.5",
+  "version": "3.0.7",
   "mcpName": "io.github.PhilflowIO/dav-mcp",
   "description": "Complete DAV integration for AI - Calendar (CalDAV), Contacts (CardDAV), and Tasks (VTODO) management via MCP protocol",
   "type": "module",

package/src/server-stdio.js

@@ -108,7 +108,7 @@ async function startStdioServer() {
   /**
    * Create MCP Server with tool handlers
    */
-  function createMCPServer() {
+  function createMCPServer(ensureInit) {
     const server = new Server(
       {
         name: process.env.MCP_SERVER_NAME || 'dav-mcp',
@@ -149,6 +149,9 @@ async function startStdioServer() {
         throw error;
       }
 
+      // Ensure DAV clients are initialized before executing any tool
+      await ensureInit();
+
       const startTime = Date.now();
       toolCallLogger.logToolCallStart(toolName, toolArgs, { transport: 'stdio' });
 
@@ -180,19 +183,34 @@ async function startStdioServer() {
     return server;
   }
 
+  // Lazy initialization flag
+  let tsdavInitialized = false;
+
+  async function ensureTsdavInitialized() {
+    if (!tsdavInitialized) {
+      await initializeTsdav();
+      tsdavInitialized = true;
+    }
+  }
+
   // Main entry point
   try {
     logger.info('Starting dav-mcp STDIO server...');
 
-    // Initialize tsdav clients
-    await initializeTsdav();
+    // Try to initialize tsdav clients eagerly, but don't fail if unavailable
+    try {
+      await initializeTsdav();
+      tsdavInitialized = true;
+    } catch (initError) {
+      logger.warn({ error: initError.message }, 'DAV server not reachable at startup — will retry on first tool call');
+    }
 
     // Initialize tool call logger
     initializeToolCallLogger();
     logger.info('Tool call logger initialized');
 
     // Create MCP server
-    const server = createMCPServer();
+    const server = createMCPServer(ensureTsdavInitialized);
     logger.debug({ count: tools.length }, 'MCP server created with tools');
 
     // Create STDIO transport

package/src/tools/calendar/delete-event.js

@@ -7,17 +7,17 @@ import { formatSuccess } from '../../formatters.js';
  */
 export const deleteEvent = {
   name: 'delete_event',
-  description: 'Delete a calendar event permanently. Requires event URL and etag',
+  description: 'Permanently delete a calendar event. WARNING: This action cannot be undone — the event is removed from the server immediately. Use only when the user explicitly requests deletion. Obtain the event URL and etag from list_events or calendar_query first. The etag ensures no conflicting changes occurred since the event was last retrieved.',
   inputSchema: {
     type: 'object',
     properties: {
       event_url: {
         type: 'string',
-        description: 'The URL of the event to delete',
+        description: 'Full URL of the event to delete. Obtain from list_events or calendar_query response.',
       },
       event_etag: {
         type: 'string',
-        description: 'The etag of the event',
+        description: 'ETag of the event for conflict detection. Obtain from the same response as the event URL. Ensures no changes were made since retrieval.',
       },
     },
     required: ['event_url', 'event_etag'],

package/src/tools/contacts/delete-contact.js

@@ -7,17 +7,17 @@ import { formatSuccess } from '../../formatters.js';
  */
 export const deleteContact = {
   name: 'delete_contact',
-  description: 'Delete a contact (vCard) permanently. Requires contact URL and etag',
+  description: 'Permanently delete a contact (vCard) from the address book. WARNING: This action cannot be undone — the contact is removed from the server immediately. Use only when the user explicitly requests deletion. Obtain the vCard URL and etag from list_contacts or addressbook_query first. The etag ensures no conflicting changes occurred since the contact was last retrieved.',
   inputSchema: {
     type: 'object',
     properties: {
       vcard_url: {
         type: 'string',
-        description: 'The URL of the vCard to delete',
+        description: 'Full URL of the vCard to delete. Obtain from list_contacts or addressbook_query response.',
       },
       vcard_etag: {
         type: 'string',
-        description: 'The etag of the vCard',
+        description: 'ETag of the vCard for conflict detection. Obtain from the same response as the vCard URL. Ensures no changes were made since retrieval.',
       },
     },
     required: ['vcard_url', 'vcard_etag'],

package/src/tools/todos/delete-todo.js

@@ -7,17 +7,17 @@ import { formatSuccess } from '../../formatters.js';
  */
 export const deleteTodo = {
   name: 'delete_todo',
-  description: 'Delete a todo/task permanently from the calendar. Cannot be undone. Requires todo URL and etag.',
+  description: 'Permanently delete a todo/task from the calendar. WARNING: This action cannot be undone — the todo is removed from the server immediately. Use only when the user explicitly requests deletion. Obtain the todo URL and etag from list_todos or todo_query first. The etag ensures no conflicting changes occurred since the todo was last retrieved.',
   inputSchema: {
     type: 'object',
     properties: {
       todo_url: {
         type: 'string',
-        description: 'The URL of the todo to delete',
+        description: 'Full URL of the todo to delete. Obtain from list_todos or todo_query response.',
       },
       todo_etag: {
         type: 'string',
-        description: 'The current ETag of the todo',
+        description: 'ETag of the todo for conflict detection. Obtain from the same response as the todo URL. Ensures no changes were made since retrieval.',
       },
     },
     required: ['todo_url', 'todo_etag'],