@alanse/clickup-multi-mcp-server 1.0.0

package/build/utils/sponsor-service.js

@@ -0,0 +1,93 @@
+/**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
+ * Sponsor Service Module
+ *
+ * Provides configuration and utilities for sponsorship functionality
+ */
+import { Logger } from '../logger.js';
+import config from '../config.js';
+// Create logger instance for this module
+const logger = new Logger('SponsorService');
+/**
+ * SponsorService - Provides sponsorship configuration and message handling
+ */
+export class SponsorService {
+    constructor() {
+        this.sponsorUrl = 'https://github.com/sponsors/taazkareem';
+        this.isEnabled = config.enableSponsorMessage;
+        logger.info('SponsorService initialized', { enabled: this.isEnabled });
+    }
+    /**
+     * Get sponsor information (for documentation/reference purposes)
+     */
+    getSponsorInfo() {
+        return {
+            isEnabled: this.isEnabled,
+            url: this.sponsorUrl
+        };
+    }
+    /**
+     * Creates a response with optional sponsorship message
+     */
+    createResponse(data, includeSponsorMessage = false) {
+        const content = [];
+        // Special handling for workspace hierarchy which contains a preformatted tree
+        if (data && typeof data === 'object' && 'hierarchy' in data && typeof data.hierarchy === 'string') {
+            // Handle workspace hierarchy specially - it contains a preformatted tree
+            content.push({
+                type: "text",
+                text: data.hierarchy
+            });
+        }
+        else if (typeof data === 'string') {
+            // If it's already a string, use it directly
+            content.push({
+                type: "text",
+                text: data
+            });
+        }
+        else {
+            // Otherwise, stringify the JSON object
+            content.push({
+                type: "text",
+                text: JSON.stringify(data, null, 2)
+            });
+        }
+        // Then add sponsorship message if enabled
+        if (this.isEnabled && includeSponsorMessage) {
+            content.push({
+                type: "text",
+                text: `\n♥ Support this project by sponsoring the developer at ${this.sponsorUrl}`
+            });
+        }
+        return { content };
+    }
+    /**
+     * Creates an error response
+     */
+    createErrorResponse(error, context) {
+        return this.createResponse({
+            error: typeof error === 'string' ? error : error.message,
+            ...context
+        });
+    }
+    /**
+     * Creates a bulk operation response with sponsorship message
+     */
+    createBulkResponse(result) {
+        return this.createResponse({
+            success: true,
+            total: result.totals.total,
+            successful: result.totals.success,
+            failed: result.totals.failure,
+            failures: result.failed.map((failure) => ({
+                id: failure.item?.id || failure.item,
+                error: failure.error.message
+            }))
+        }, true); // Always include sponsor message for bulk operations
+    }
+}
+// Export a singleton instance
+export const sponsorService = new SponsorService();

package/build/utils/token-utils.js

@@ -0,0 +1,49 @@
+/**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
+ * Token Utilities
+ *
+ * Functions for estimating token counts for LLM processing
+ */
+/**
+ * Simple heuristic to estimate token count from text
+ * Based on the approximate ratio of 4 characters per token for English text
+ *
+ * @param text Text to estimate tokens for
+ * @returns Estimated token count
+ */
+export function estimateTokensFromText(text) {
+    if (!text)
+        return 0;
+    // Characters per token varies by language, but ~4 chars per token
+    // is a reasonable approximation for English text
+    const CHARS_PER_TOKEN = 4;
+    // Add some overhead for non-text elements and special tokens
+    const OVERHEAD_FACTOR = 1.1;
+    return Math.ceil((text.length / CHARS_PER_TOKEN) * OVERHEAD_FACTOR);
+}
+/**
+ * Estimate tokens for a JSON object
+ *
+ * @param obj Object to estimate tokens for
+ * @returns Estimated token count
+ */
+export function estimateTokensFromObject(obj) {
+    // Convert to JSON string
+    const jsonString = JSON.stringify(obj);
+    // Use text estimation on the JSON string
+    // JSON has more special chars than plain text, so we adjust overhead
+    return Math.ceil(estimateTokensFromText(jsonString) * 1.2);
+}
+/**
+ * Check if an object would exceed the token limit when serialized to JSON
+ *
+ * @param obj Object to check
+ * @param tokenLimit Token limit to check against
+ * @returns Whether the object would exceed the token limit
+ */
+export function wouldExceedTokenLimit(obj, tokenLimit) {
+    const estimatedTokens = estimateTokensFromObject(obj);
+    return estimatedTokens > tokenLimit;
+}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@alanse/clickup-multi-mcp-server",
+  "version": "1.0.0",
+  "description": "ClickUp MCP Server with Multi-Workspace Support - Integrate multiple ClickUp workspaces with AI through Model Context Protocol",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "clickup-mcp-server": "build/index.js"
+  },
+  "files": [
+    "build",
+    "README.md",
+    "LICENSE",
+    "Dockerfile",
+    "smithery.yaml"
+  ],
+  "scripts": {
+    "build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
+    "start": "node build/index.js",
+    "dev": "tsc -w",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "clickup",
+    "mcp",
+    "ai",
+    "tasks",
+    "project-management",
+    "model-context-protocol",
+    "clickup-server",
+    "clickup-mcp-server",
+    "task-management",
+    "productivity",
+    "automation",
+    "workflow",
+    "team-collaboration",
+    "artificial-intelligence",
+    "project-tracking",
+    "task-tracking",
+    "project-planning",
+    "clickup-integration",
+    "clickup-api",
+    "clickup-automation",
+    "task-organization",
+    "project-organization"
+  ],
+  "author": "Daichi Okazaki（Alanse）",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/da-okazaki/clickup-multi-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/da-okazaki/clickup-multi-mcp-server/issues"
+  },
+  "homepage": "https://github.com/da-okazaki/clickup-multi-mcp-server#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.3",
+    "axios": "^1.6.7",
+    "cors": "^2.8.5",
+    "dotenv": "^16.5.0",
+    "express": "^5.1.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.1",
+    "@types/node": "^20.11.16",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0 <23.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/smithery.yaml

@@ -0,0 +1,23 @@
+# Smithery configuration file: https://smithery.ai/docs/config#smitheryyaml
+
+dockerfile: Dockerfile
+
+startCommand:
+  type: stdio
+  configSchema:
+    # JSON Schema defining the configuration options for the MCP.
+    type: object
+    required:
+      - clickupApiKey
+      - clickupTeamId
+    properties:
+      clickupApiKey:
+        type: string
+        description: Your ClickUp API key.
+      clickupTeamId:
+        type: string
+        description: Your ClickUp Team ID.
+  commandFunction:
+    # A function that produces the CLI command to start the MCP on stdio.
+    |-
+    (config) => ({ command: 'node', args: ['build/index.js'], env: { CLICKUP_API_KEY: config.clickupApiKey, CLICKUP_TEAM_ID: config.clickupTeamId } })