@respond-io/mcp-server 1.0.0

package/dist/utils/api.js

@@ -0,0 +1,340 @@
+import { RespondIO, RespondIOError } from "@respond-io/typescript-sdk";
+/**
+ * Enhanced SDK Client Manager with best practices
+ */
+class SdkClientManager {
+    static instance;
+    clients = new Map();
+    healthStatus = new Map();
+    healthCheckInterval;
+    defaultConfig = {
+        maxRetries: 3,
+        timeout: 30000,
+    };
+    constructor() {
+        // Start periodic health checks
+        this.startHealthChecks();
+        // Handle graceful shutdown
+        this.setupGracefulShutdown();
+    }
+    static getInstance() {
+        if (!SdkClientManager.instance) {
+            SdkClientManager.instance = new SdkClientManager();
+        }
+        return SdkClientManager.instance;
+    }
+    /**
+     * Create a client key for caching
+     * Uses a hash of the token to avoid collisions while keeping keys readable
+     */
+    createClientKey(config) {
+        // Use first 8 chars + last 4 chars + length to reduce collision risk
+        const tokenPreview = config.apiToken.length > 12
+            ? `${config.apiToken.substring(0, 8)}...${config.apiToken.substring(config.apiToken.length - 4)}`
+            : config.apiToken.substring(0, 12);
+        return `${config.baseUrl}:${tokenPreview}`;
+    }
+    /**
+     * Get or create an SDK client with enhanced configuration
+     */
+    getClient(config) {
+        const key = this.createClientKey(config);
+        if (this.clients.has(key)) {
+            const client = this.clients.get(key);
+            // Check if client is healthy
+            const health = this.healthStatus.get(key);
+            if (health && !health.isHealthy && this.shouldRecreateClient(health)) {
+                console.warn(`Recreating unhealthy client for ${config.baseUrl}`);
+                this.clients.delete(key);
+                this.healthStatus.delete(key);
+            }
+            else {
+                return client;
+            }
+        }
+        // Create new client with merged configuration
+        const fullConfig = { ...this.defaultConfig, ...config };
+        const client = new RespondIO(fullConfig);
+        // Cache the client
+        this.clients.set(key, client);
+        this.healthStatus.set(key, {
+            isHealthy: true,
+            lastChecked: new Date(),
+            errorCount: 0,
+        });
+        return client;
+    }
+    /**
+     * Determine if a client should be recreated based on health status
+     */
+    shouldRecreateClient(health) {
+        const now = new Date();
+        const timeSinceLastCheck = now.getTime() - health.lastChecked.getTime();
+        // Recreate if unhealthy and checked more than 5 minutes ago, or error count > 5
+        return health.errorCount > 5 || timeSinceLastCheck > 5 * 60 * 1000;
+    }
+    /**
+     * Mark a client as unhealthy (called when API calls fail)
+     */
+    markClientUnhealthy(config) {
+        const key = this.createClientKey(config);
+        const health = this.healthStatus.get(key);
+        if (health) {
+            health.isHealthy = false;
+            health.errorCount++;
+            health.lastChecked = new Date();
+            console.warn(`Client marked as unhealthy: ${key}, errors: ${health.errorCount}`);
+        }
+    }
+    /**
+     * Perform health check on a client
+     */
+    async performHealthCheck(key, client) {
+        const startTime = Date.now();
+        try {
+            // Perform a lightweight health check (list users with limit 1)
+            await client.space.listUsers({ limit: 1 });
+            const responseTime = Date.now() - startTime;
+            this.healthStatus.set(key, {
+                isHealthy: true,
+                lastChecked: new Date(),
+                errorCount: 0,
+                responseTime,
+            });
+        }
+        catch (error) {
+            const health = this.healthStatus.get(key) || { errorCount: 0 };
+            this.healthStatus.set(key, {
+                isHealthy: false,
+                lastChecked: new Date(),
+                errorCount: health.errorCount + 1,
+                responseTime: Date.now() - startTime,
+            });
+            console.warn(`Health check failed for client ${key}:`, error);
+        }
+    }
+    /**
+     * Start periodic health checks
+     */
+    startHealthChecks() {
+        // Run health checks every 10 minutes
+        this.healthCheckInterval = setInterval(() => {
+            // Fire and forget - we don't need to wait for health checks
+            Array.from(this.clients.entries()).forEach(([key, client]) => {
+                this.performHealthCheck(key, client).catch((error) => {
+                    console.warn(`Health check failed for ${key}:`, error);
+                });
+            });
+        }, 10 * 60 * 1000);
+        // Allow process to exit even if interval is running (useful for tests)
+        this.healthCheckInterval.unref();
+    }
+    /**
+     * Stop health checks
+     */
+    stopHealthChecks() {
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+            this.healthCheckInterval = undefined;
+        }
+    }
+    /**
+     * Setup graceful shutdown handlers
+     */
+    setupGracefulShutdown() {
+        const shutdown = () => {
+            // eslint-disable-next-line no-console
+            console.warn("Shutting down SDK client manager...");
+            this.stopHealthChecks();
+            // Close any connections if needed
+        };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+        process.on("beforeExit", shutdown);
+    }
+    /**
+     * Get client statistics
+     */
+    getClientStats() {
+        const healthyClients = Array.from(this.healthStatus.values()).filter((health) => health.isHealthy).length;
+        const unhealthyClients = this.healthStatus.size - healthyClients;
+        return {
+            totalClients: this.clients.size,
+            healthyClients,
+            unhealthyClients,
+            healthStatus: Object.fromEntries(this.healthStatus),
+        };
+    }
+}
+// Export singleton instance
+export const sdkClientManager = SdkClientManager.getInstance();
+/**
+ * Get comprehensive client statistics and health information
+ */
+export function getSdkClientStats() {
+    const stats = sdkClientManager.getClientStats();
+    return {
+        ...stats,
+        uptime: process.uptime(),
+        memoryUsage: process.memoryUsage(),
+        nodeVersion: process.version,
+    };
+}
+/**
+ * Initialize client monitoring (call this once at app startup).
+ * Logs cached client stats periodically; SdkClientManager already runs health checks.
+ */
+export function initializeClientMonitoring() {
+    // eslint-disable-next-line no-console
+    console.warn("SDK Client monitoring initialized");
+    const statsInterval = setInterval(() => {
+        const stats = getSdkClientStats();
+        // eslint-disable-next-line no-console
+        console.warn("Client Stats:", {
+            total: stats.totalClients,
+            healthy: stats.healthyClients,
+            unhealthy: stats.unhealthyClients,
+        });
+    }, 5 * 60 * 1000);
+    // Allow process to exit even if interval is running (useful for tests)
+    statsInterval.unref();
+}
+/**
+ * Formats a contact identifier for the Respond.io SDK.
+ * Accepts various input formats and converts them to the proper SDK format.
+ *
+ * @param {string} identifier - The contact identifier in flexible format
+ * @returns {ContactIdentifier} - Properly formatted contact identifier
+ */
+export function formatContactIdentifier(identifier) {
+    // If already in SDK format, return as-is
+    if (identifier.startsWith("id:") ||
+        identifier.startsWith("email:") ||
+        identifier.startsWith("phone:")) {
+        return identifier;
+    }
+    // If it's an email address
+    if (identifier.includes("@")) {
+        return `email:${identifier}`;
+    }
+    // If it starts with +, it's definitely a phone number
+    if (identifier.startsWith("+")) {
+        return `phone:${identifier}`;
+    }
+    // If it's all digits, check length to guess type:
+    // - Contact IDs are typically large numbers (6+ digits)
+    // - Phone numbers without + are usually 10-15 digits
+    // We'll treat shorter numbers (< 6 digits) as contact IDs, longer as phone
+    if (/^\d+$/.test(identifier)) {
+        // If it's a short number (< 6 digits), likely a contact ID
+        // Otherwise, treat as phone number (add + prefix)
+        if (identifier.length < 6) {
+            return `id:${parseInt(identifier)}`;
+        }
+        return `phone:+${identifier}`;
+    }
+    // Default: treat as email (e.g. plain email or unknown format)
+    return `email:${identifier}`;
+}
+/**
+ * Creates a new Respond.io SDK client with enhanced error handling and caching.
+ *
+ * @param {string} apiBaseUrl - The base URL for the API.
+ * @param {string} mode - The mode of operation ("http" or "stdio").
+ * @param {Ctx} ctx - The context object containing request information.
+ * @returns {RespondIO} - A configured Respond.io SDK client.
+ * @throws {Error} - Throws an error if the API base URL or token is not set.
+ */
+export function createSdkClient(apiBaseUrl, mode, ctx) {
+    const apiToken = mode === "http" && ctx?.requestInfo?.headers?.authorization
+        ? ctx.requestInfo.headers.authorization
+        : process.env.RESPONDIO_API_KEY;
+    if (!apiBaseUrl) {
+        throw new Error("RESPONDIO_BASE_URL is not set in the environment");
+    }
+    if (!apiToken) {
+        throw new Error("RESPONDIO_API_KEY is not set in the environment");
+    }
+    const cleanToken = apiToken.startsWith("Bearer ") ? apiToken.slice(7) : apiToken;
+    try {
+        const client = sdkClientManager.getClient({
+            apiToken: cleanToken,
+            baseUrl: apiBaseUrl,
+        });
+        return client;
+    }
+    catch (error) {
+        // Mark client as unhealthy if creation fails
+        sdkClientManager.markClientUnhealthy({ apiToken: cleanToken, baseUrl: apiBaseUrl });
+        throw error;
+    }
+}
+/**
+ * Converts a string to a `CallToolResult` object with a text content type.
+ *
+ * @param {string} text - The text to be converted.
+ * @returns {CallToolResult} - A `CallToolResult` object.
+ */
+const asCallToolText = (text) => ({
+    content: [{ type: "text", text }],
+});
+/**
+ * Safely stringifies a value, handling circular references and BigInts.
+ *
+ * @param {unknown} data - The data to be stringified.
+ * @returns {string} - The stringified data.
+ */
+function safeStringify(data) {
+    const seen = new WeakSet();
+    return JSON.stringify(data, (_k, v) => {
+        if (typeof v === "bigint") {
+            return v.toString();
+        }
+        if (v && typeof v === "object") {
+            if (seen.has(v)) {
+                return "[Circular]";
+            }
+            seen.add(v);
+        }
+        return v;
+    }, 2);
+}
+/**
+ * Handles a successful SDK response by stringifying the data and returning it as a `CallToolResult`.
+ *
+ * @param {unknown} data - The response data from the SDK.
+ * @returns {CallToolResult} - A `CallToolResult` object containing the stringified response data.
+ */
+export const handleSdkResponse = (data) => {
+    if (typeof data === "undefined") {
+        return asCallToolText("No data returned from API.");
+    }
+    return asCallToolText(safeStringify(data));
+};
+/**
+ * Handles an SDK error by creating a descriptive error message and returning it as a `CallToolResult`.
+ *
+ * @param {unknown} error - The error object.
+ * @returns {CallToolResult} - A `CallToolResult` object containing the error message.
+ */
+export const handleSdkError = (error) => {
+    let message;
+    if (error instanceof RespondIOError) {
+        const sdkError = error;
+        message = `API Error ${sdkError.statusCode}: ${sdkError.message}`;
+        if (sdkError.isRateLimitError() && sdkError.rateLimitInfo?.retryAfter) {
+            message += ` (Rate limit exceeded. Retry after: ${sdkError.rateLimitInfo.retryAfter} seconds)`;
+        }
+    }
+    else if (error instanceof Error) {
+        message = `Error: ${error.message}`;
+    }
+    else {
+        message = `Unknown Error: ${String(error)}`;
+    }
+    if (process.env.DEBUG && error instanceof Error && error.stack) {
+        message += `\nStack: ${error.stack}`;
+    }
+    return asCallToolText(message);
+};
+//# sourceMappingURL=api.js.map

package/dist/utils/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/utils/api.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,108 @@
+{
+    "name": "@respond-io/mcp-server",
+    "version": "1.0.0",
+    "description": "Model Context Protocol server for Respond.io API integration with STDIO and HTTP/SSE support",
+    "type": "module",
+    "main": "dist/index.js",
+    "bin": {
+        "@respond-io/mcp-server": "dist/index.js"
+    },
+    "scripts": {
+        "prebuild": "npm run clean",
+        "build": "tsc && chmod +x dist/index.js",
+        "dev": "tsx watch src/index.ts",
+        "start": "node dist/index.js",
+        "start:stdio": "MCP_SERVER_MODE=stdio node dist/index.js",
+        "start:http": "MCP_SERVER_MODE=http node dist/index.js",
+        "start:local": "npm run build && MCP_SERVER_MODE=stdio npx @modelcontextprotocol/inspector node dist/index.js",
+        "start:debug": "DEBUG=true LOG_LEVEL=debug node dist/index.js",
+        "lint": "eslint src/**/*.ts",
+        "lint:fix": "eslint src/**/*.ts --fix",
+        "format": "prettier --write \"src/**/*.ts\"",
+        "format:check": "prettier --check \"src/**/*.ts\"",
+        "type-check": "tsc --noEmit",
+        "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+        "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch",
+        "test:coverage": "node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage",
+        "prepare": "npm run build",
+        "verify-registry": "npm config get registry",
+        "docker:build": "docker build -t respondio-mcp-server .",
+        "docker:run": "docker run -p 3000:3000 --env-file .env respondio-mcp-server",
+        "docker:compose:up": "docker-compose up -d",
+        "docker:compose:down": "docker-compose down",
+        "docker:compose:logs": "docker-compose logs -f",
+        "health-check": "curl -f http://localhost:3000/health || exit 1",
+        "validate": "npm run lint && npm run type-check",
+        "prepublishOnly": "npm run validate && npm run build && cd dist",
+        "prepack": "npm run build",
+        "clean": "rm -rf dist coverage",
+        "release:dev": "npm publish --registry https://npm.pkg.github.com/",
+        "release": "npm publish --registry https://registry.npmjs.org/ --access public || (echo 'Release failed' && exit 1)"
+    },
+    "keywords": [
+        "mcp",
+        "model-context-protocol",
+        "respondio",
+        "messaging",
+        "api",
+        "customer-engagement",
+        "sse",
+        "server-sent-events",
+        "http",
+        "stdio",
+        "whatsapp",
+        "facebook",
+        "instagram",
+        "telegram"
+    ],
+    "author": "Your Name <your.email@example.com>",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/respond-io/mcp-server.git"
+    },
+    "bugs": {
+        "url": "https://github.com/respond-io/mcp-server/issues"
+    },
+    "homepage": "https://github.com/respond-io/mcp-server#readme",
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.20.2",
+        "@respond-io/typescript-sdk": "https://registry.npmjs.org/@respond-io/typescript-sdk/-/typescript-sdk-1.2.0.tgz",
+        "cors": "^2.8.5",
+        "express": "^5.1.0",
+        "zod": "^3.24.2"
+    },
+    "devDependencies": {
+        "@eslint/eslintrc": "^3.3.1",
+        "@eslint/js": "^9.39.0",
+        "@modelcontextprotocol/inspector": "^0.17.2",
+        "@types/body-parser": "^1.19.6",
+        "@types/cors": "^2.8.19",
+        "@types/express": "^5.0.5",
+        "@types/node": "^24.9.2",
+        "@typescript-eslint/eslint-plugin": "^8.46.2",
+        "@typescript-eslint/parser": "^8.46.2",
+        "eslint": "^9.39.0",
+        "eslint-config-prettier": "^10.1.8",
+        "eslint-plugin-prettier": "^5.5.4",
+        "globals": "^16.5.0",
+        "prettier": "^3.6.2",
+        "ts-node": "^10.9.2",
+        "tsx": "^4.20.6",
+        "typescript": "^5.9.3",
+        "@types/jest": "^29.5.14",
+        "jest": "^29.7.0",
+        "ts-jest": "^29.2.5"
+    },
+    "engines": {
+        "node": ">=18.0.0",
+        "npm": ">=9.0.0"
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE",
+        "package.json",
+        "CHANGELOG.md"
+    ]
+}