@taazkareem/clickup-mcp-server 0.6.7 → 0.6.9

package/README.md

@@ -6,7 +6,7 @@
 
 A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI applications. This server allows AI agents to interact with ClickUp tasks, spaces, lists, and folders through a standardized protocol.
 
-> 🚧 **Status Update:** Rolling out v0.6.6 will add Global Task Lookup with smart disambiguation, Start Date Support for tasks with natural language expressions, Complete Tag Support including natural language tag color commands, Subtasks Support, Custom ID Support, and Logging Fixes
+> 🚧 **Status Update:** Rolling out v0.6.9 will add Global Task Lookup with smart disambiguation, Start Date Support for tasks with natural language expressions, Complete Tag Support including natural language tag color commands, Subtasks Support, Custom ID Support, and Logging Fixes
 
 ## Setup
 

package/build/mcp-tools.js

@@ -0,0 +1,64 @@
+import { Logger } from "./logger.js";
+// Create a logger instance
+const logger = new Logger('MCPTools');
+/**
+ * Register a handler for a tool that may receive JSON string parameters
+ * This wrapper ensures that array and object parameters are properly parsed
+ *
+ * @param server MCP Server instance
+ * @param name Tool name
+ * @param handler Handler function
+ */
+export function registerToolHandler(server, name, handler) {
+    // Create a wrapper handler that pre-processes parameters
+    const wrappedHandler = async (params) => {
+        logger.debug(`Processing parameters for tool ${name}`, { params });
+        try {
+            // Process the parameters before passing them to the actual handler
+            const processedParams = {};
+            // Process each parameter - try to parse strings that might be JSON
+            for (const [key, value] of Object.entries(params)) {
+                if (typeof value === 'string') {
+                    try {
+                        // Check if this might be a JSON array or object
+                        if ((value.startsWith('[') && value.endsWith(']')) ||
+                            (value.startsWith('{') && value.endsWith('}'))) {
+                            try {
+                                processedParams[key] = JSON.parse(value);
+                                logger.debug(`Parsed JSON parameter: ${key}`, { original: value, parsed: processedParams[key] });
+                            }
+                            catch (parseError) {
+                                // If parsing fails, use the original string
+                                processedParams[key] = value;
+                                logger.debug(`Failed to parse JSON for parameter: ${key}, using original`, { error: parseError.message });
+                            }
+                        }
+                        else {
+                            processedParams[key] = value;
+                        }
+                    }
+                    catch (error) {
+                        // If there's any error, use the original value
+                        processedParams[key] = value;
+                        logger.debug(`Error processing parameter: ${key}`, { error: error.message });
+                    }
+                }
+                else {
+                    // Non-string values are used as-is
+                    processedParams[key] = value;
+                }
+            }
+            logger.debug(`Processed parameters for tool ${name}`, { processedParams });
+            // Call the original handler with processed parameters
+            return handler(processedParams);
+        }
+        catch (error) {
+            logger.error(`Error in wrapped handler for tool ${name}:`, { error: error.stack || error.message });
+            throw error;
+        }
+    };
+    // Use setRequestHandler to register the wrapped handler
+    logger.info(`Registering wrapped handler for tool: ${name}`);
+    // Override the tool's handler in the CallTool switch statement
+    // The server.ts file will use the switch case to call this handler
+}

package/build/server-state.js

@@ -0,0 +1,93 @@
+/**
+ * Server State Management Module
+ *
+ * This module provides shared state management for the MCP server,
+ * particularly for controlling shutdown behavior and tracking busy states.
+ */
+// State variables
+let serverBusyState = false; // Tracks if server is doing critical work
+let gracePeriodActive = false; // Tracks if we're in post-initialization grace period
+let gracePeriodTimer = null;
+export const GRACE_PERIOD_MS = 10000; // 10 second grace period after startup
+/**
+ * Logging helper that avoids circular dependency
+ */
+function safeLog(level, message, data) {
+    // Use console as a fallback to avoid circular dependency with logger
+    const timestamp = new Date().toISOString();
+    if (level === 'error') {
+        console.error(`[${timestamp}] ${level.toUpperCase()}: ${message}`, data || '');
+    }
+    else if (level === 'debug' && process.env.DEBUG) {
+        console.debug(`[${timestamp}] ${level.toUpperCase()}: ${message}`, data || '');
+    }
+    else if (level !== 'debug') {
+        console.log(`[${timestamp}] ${level.toUpperCase()}: ${message}`, data || '');
+    }
+}
+/**
+ * Set the server as busy doing critical work that shouldn't be interrupted
+ * @param busy Whether the server is currently busy with critical operations
+ */
+export function setServerBusy(busy) {
+    serverBusyState = busy;
+    safeLog('debug', `Server busy state set to: ${busy}`);
+}
+/**
+ * Start grace period after initialization to prevent immediate shutdown
+ */
+export function startGracePeriod() {
+    gracePeriodActive = true;
+    safeLog('debug', `Starting ${GRACE_PERIOD_MS}ms grace period to prevent premature shutdown`);
+    if (gracePeriodTimer) {
+        clearTimeout(gracePeriodTimer);
+    }
+    gracePeriodTimer = setTimeout(() => {
+        gracePeriodActive = false;
+        safeLog('debug', 'Grace period ended, server will now respond to shutdown signals');
+        gracePeriodTimer = null;
+    }, GRACE_PERIOD_MS);
+}
+/**
+ * Cancel the grace period if needed
+ */
+export function cancelGracePeriod() {
+    if (gracePeriodTimer) {
+        clearTimeout(gracePeriodTimer);
+        gracePeriodTimer = null;
+    }
+    gracePeriodActive = false;
+    safeLog('debug', 'Grace period canceled, server will now respond to shutdown signals');
+}
+/**
+ * Check if the server should ignore shutdown signals
+ * @returns true if shutdown signals should be ignored
+ */
+export function shouldIgnoreShutdown() {
+    // Ignore shutdown if explicitly configured via environment variable
+    if (process.env.FORCE_KEEP_ALIVE === 'true') {
+        return true;
+    }
+    // Ignore shutdown during the grace period after startup
+    if (gracePeriodActive) {
+        return true;
+    }
+    // Ignore shutdown if the server is doing critical work
+    if (serverBusyState) {
+        return true;
+    }
+    // Otherwise, allow normal shutdown
+    return false;
+}
+/**
+ * Check if grace period is currently active
+ */
+export function isGracePeriodActive() {
+    return gracePeriodActive;
+}
+/**
+ * Check if server is currently in busy state
+ */
+export function isServerBusy() {
+    return serverBusyState;
+}

package/build/server.js

@@ -19,7 +19,7 @@ const logger = new Logger('Server');
 const { workspace } = clickUpServices;
 export const server = new Server({
     name: "clickup-mcp-server",
-    version: "0.6.4",
+    version: "0.6.9",
 }, {
     capabilities: {
         tools: {},

package/build/server.log

@@ -0,0 +1,76 @@
+Logging initialized to /Volumes/Code/Projects/MCP/clickup-mcp-server/build/server.log
+[2025-04-03T23:48:48.480Z] [PID:89934] INFO: [SponsorService] SponsorService initialized
+{
+  "enabled": true
+}
+[2025-04-03T23:48:48.526Z] [PID:89934] INFO: [SharedServices] Creating shared ClickUp services singleton
+[2025-04-03T23:48:48.526Z] [PID:89934] INFO: [ClickUpServices] Starting ClickUp services initialization
+{
+  "teamId": "9014370478",
+  "baseUrl": "https://api.clickup.com/api/v2"
+}
+[2025-04-03T23:48:48.526Z] [PID:89934] INFO: [ClickUpServices] Initializing ClickUp Workspace service
+[2025-04-03T23:48:48.528Z] [PID:89934] DEBUG: [ClickUp:WorkspaceService] Initialized WorkspaceService (teamId="9014370478" baseUrl="https://api.clickup.com/api/v2")
+[2025-04-03T23:48:48.528Z] [PID:89934] INFO: [ClickUpServices] Initializing ClickUp Task service
+[2025-04-03T23:48:48.528Z] [PID:89934] DEBUG: [ClickUp:TaskService] Initialized TaskService (teamId="9014370478" baseUrl="https://api.clickup.com/api/v2")
+[2025-04-03T23:48:48.528Z] [PID:89934] INFO: [ClickUp:TaskService] Operation: constructor
+{
+  "usingSharedWorkspaceService": true
+}
+[2025-04-03T23:48:48.529Z] [PID:89934] DEBUG: [ClickUp:ListService] Initialized ListService (teamId="9014370478" baseUrl="https://api.clickup.com/api/v2")
+[2025-04-03T23:48:48.529Z] [PID:89934] INFO: [ClickUp:TaskService] Operation: constructor
+{
+  "initialized": true
+}
+[2025-04-03T23:48:48.529Z] [PID:89934] INFO: [ClickUp:TaskService] Operation: constructor
+{
+  "initialized": true
+}
+[2025-04-03T23:48:48.529Z] [PID:89934] INFO: [ClickUpServices] Initializing ClickUp List service
+[2025-04-03T23:48:48.529Z] [PID:89934] DEBUG: [ClickUp:ListService] Initialized ListService (teamId="9014370478" baseUrl="https://api.clickup.com/api/v2")
+[2025-04-03T23:48:48.529Z] [PID:89934] INFO: [ClickUpServices] Initializing ClickUp Folder service
+[2025-04-03T23:48:48.529Z] [PID:89934] DEBUG: [ClickUp:FolderService] Initialized FolderService (teamId="9014370478" baseUrl="https://api.clickup.com/api/v2")
+[2025-04-03T23:48:48.529Z] [PID:89934] INFO: [ClickUpServices] Initializing ClickUp Tag service
+[2025-04-03T23:48:48.529Z] [PID:89934] DEBUG: [ClickUp:ClickUpTagService] Initialized ClickUpTagService (teamId="9014370478" baseUrl="https://api.clickup.com/api/v2")
+[2025-04-03T23:48:48.529Z] [PID:89934] INFO: [ClickUpServices] All ClickUp services initialized successfully
+{
+  "services": [
+    "workspace",
+    "task",
+    "list",
+    "folder",
+    "tag"
+  ],
+  "baseUrl": "https://api.clickup.com/api/v2"
+}
+[2025-04-03T23:48:48.529Z] [PID:89934] INFO: [SharedServices] Services initialization complete
+{
+  "services": "workspace, task, list, folder, tag",
+  "teamId": "9014370478"
+}
+[2025-04-03T23:48:48.530Z] [PID:89934] INFO: [BulkService] BulkService initialized
+[2025-04-03T23:48:48.530Z] [PID:89934] INFO: [BulkService] BulkService initialized
+[2025-04-03T23:48:48.531Z] [PID:89934] INFO: Starting ClickUp MCP Server...
+[2025-04-03T23:48:48.531Z] [PID:89934] INFO: Server environment
+{
+  "pid": 89934,
+  "node": "v23.5.0",
+  "os": "darwin",
+  "arch": "x64"
+}
+[2025-04-03T23:48:48.531Z] [PID:89934] INFO: Configuring server request handlers
+[2025-04-03T23:48:48.531Z] [PID:89934] INFO: [Server] Registering server request handlers
+[2025-04-03T23:48:48.531Z] [PID:89934] INFO: [Server] Registering tool handlers
+{
+  "toolCount": 31,
+  "categories": [
+    "workspace",
+    "task",
+    "list",
+    "folder",
+    "tag"
+  ]
+}
+[2025-04-03T23:48:48.532Z] [PID:89934] INFO: Connecting to MCP stdio transport
+[2025-04-03T23:48:48.532Z] [PID:89934] INFO: Server startup complete - ready to handle requests
+[2025-04-03T23:48:49.141Z] [PID:89934] DEBUG: [Server] Received ListTools request

package/build/services/clickup/task/handlers.js

@@ -0,0 +1 @@
+export {};