mcp-quickbase 2.0.1

package/dist/mcp/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * MCP (Model Context Protocol) module exports
+ */
+__exportStar(require("./server"), exports);
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,2CAAyB"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,19 @@
+import { Request, Response } from 'express';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+/**
+ * Create and configure an MCP server instance
+ */
+export declare function createMcpServer(): McpServer;
+/**
+ * Register tools with an existing MCP server
+ */
+export declare function registerMcpTools(server: McpServer): void;
+/**
+ * Create an HTTP transport for the MCP server
+ */
+export declare function createHttpTransport(): StreamableHTTPServerTransport;
+/**
+ * Handle an MCP request via HTTP
+ */
+export declare function handleMcpRequest(server: McpServer, transport: StreamableHTTPServerTransport, req: Request, res: Response): Promise<void>;

package/dist/mcp/server.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMcpServer = createMcpServer;
+exports.registerMcpTools = registerMcpTools;
+exports.createHttpTransport = createHttpTransport;
+exports.handleMcpRequest = handleMcpRequest;
+/**
+ * MCP Server implementation using the official Model Context Protocol SDK
+ */
+const crypto_1 = require("crypto");
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
+const logger_1 = require("../utils/logger");
+const tools_1 = require("../tools");
+const validation_1 = require("../utils/validation");
+const logger = (0, logger_1.createLogger)('mcp-server');
+/**
+ * Create and configure an MCP server instance
+ */
+function createMcpServer() {
+    // Initialize the MCP server with our app info
+    const server = new mcp_js_1.McpServer({
+        name: 'Quickbase MCP Server',
+        version: '2.0.0',
+    });
+    logger.info('MCP Server created');
+    return server;
+}
+/**
+ * Register tools with an existing MCP server
+ */
+function registerMcpTools(server) {
+    registerTools(server);
+}
+/**
+ * Register all tools with the MCP server
+ */
+function registerTools(server) {
+    const tools = tools_1.toolRegistry.getAllTools();
+    tools.forEach(tool => {
+        // Create a Zod schema from our tool's parameter schema
+        const schema = (0, validation_1.createMcpZodSchema)(tool.paramSchema);
+        // Register the tool with the MCP server
+        server.tool(tool.name, tool.description, schema, async (params) => {
+            try {
+                logger.info(`Executing MCP tool: ${tool.name}`);
+                const apiResponse = await tool.execute(params);
+                // Handle API response - only return the data if successful
+                if (!apiResponse.success || apiResponse.error) {
+                    const errorMessage = apiResponse.error?.message || 'Tool execution failed';
+                    logger.error(`Tool ${tool.name} failed`, { error: apiResponse.error });
+                    throw new Error(errorMessage);
+                }
+                // Ensure proper JSON formatting by using a standardized response structure
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(apiResponse.data, null, 2)
+                        }]
+                };
+            }
+            catch (error) {
+                logger.error(`Error executing MCP tool ${tool.name}`, { error });
+                throw error;
+            }
+        });
+        logger.info(`Registered MCP tool: ${tool.name}`);
+    });
+    logger.info(`Registered ${tools.length} tools with MCP Server`);
+}
+/**
+ * Create an HTTP transport for the MCP server
+ */
+function createHttpTransport() {
+    // Create a new transport with proper session management
+    // Following the TypeScript SDK examples for HTTP transport
+    return new streamableHttp_js_1.StreamableHTTPServerTransport({
+        sessionIdGenerator: () => (0, crypto_1.randomUUID)(),
+        enableJsonResponse: true
+    });
+}
+/**
+ * Handle an MCP request via HTTP
+ */
+async function handleMcpRequest(server, transport, req, res) {
+    try {
+        logger.info('Handling MCP request');
+        await transport.handleRequest(req, res, req.body);
+    }
+    catch (error) {
+        logger.error('Error handling MCP request', { error });
+        res.status(500).json({
+            jsonrpc: '2.0',
+            error: {
+                code: -32000,
+                message: error instanceof Error ? error.message : 'Unknown error'
+            },
+            id: req.body?.id || null
+        });
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp-stdio-server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/mcp-stdio-server.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * MCP Stdio Server for Claude CLI integration
+ */
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const dotenv_1 = __importDefault(require("dotenv"));
+const logger_1 = require("./utils/logger");
+const quickbase_1 = require("./client/quickbase");
+const cache_1 = require("./utils/cache");
+const tools_1 = require("./tools");
+const validation_1 = require("./utils/validation");
+// Load environment variables
+dotenv_1.default.config();
+const logger = (0, logger_1.createLogger)('mcp-stdio-server');
+/**
+ * Main server function
+ */
+async function main() {
+    try {
+        // Initialize the MCP server
+        const server = new mcp_js_1.McpServer({
+            name: 'Quickbase MCP Server',
+            version: '2.0.0',
+        });
+        logger.info('MCP Server created');
+        // Initialize Quickbase client
+        const config = {
+            realmHost: process.env.QUICKBASE_REALM_HOST || '',
+            userToken: process.env.QUICKBASE_USER_TOKEN || '',
+            appId: process.env.QUICKBASE_APP_ID,
+            cacheEnabled: process.env.QUICKBASE_CACHE_ENABLED !== 'false',
+            cacheTtl: parseInt(process.env.QUICKBASE_CACHE_TTL || '3600', 10),
+            debug: process.env.DEBUG === 'true'
+        };
+        // Validate required configuration
+        if (!config.realmHost || !config.userToken) {
+            throw new Error('QUICKBASE_REALM_HOST and QUICKBASE_USER_TOKEN are required');
+        }
+        // Validate realm host format
+        if (!config.realmHost.match(/^[a-zA-Z0-9-]+\.quickbase\.com$/)) {
+            throw new Error('QUICKBASE_REALM_HOST must be in format: yourcompany.quickbase.com');
+        }
+        // Validate cache TTL
+        if (isNaN(config.cacheTtl) || config.cacheTtl <= 0) {
+            throw new Error('QUICKBASE_CACHE_TTL must be a positive number');
+        }
+        const quickbaseClient = new quickbase_1.QuickbaseClient(config);
+        const cacheService = new cache_1.CacheService(config.cacheTtl, config.cacheEnabled);
+        // Initialize tools
+        (0, tools_1.initializeTools)(quickbaseClient, cacheService);
+        // Register tools with MCP server
+        const tools = tools_1.toolRegistry.getAllTools();
+        tools.forEach(tool => {
+            const schema = (0, validation_1.createMcpZodSchema)(tool.paramSchema);
+            server.tool(tool.name, tool.description, schema, async (params) => {
+                try {
+                    logger.info(`Executing MCP tool: ${tool.name}`);
+                    const apiResponse = await tool.execute(params);
+                    // Handle API response - only return the data if successful
+                    if (!apiResponse.success || apiResponse.error) {
+                        const errorMessage = apiResponse.error?.message || 'Tool execution failed';
+                        logger.error(`Tool ${tool.name} failed`, { error: apiResponse.error });
+                        throw new Error(errorMessage);
+                    }
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify(apiResponse.data, null, 2)
+                            }]
+                    };
+                }
+                catch (error) {
+                    logger.error(`Error executing MCP tool ${tool.name}`, { error });
+                    throw error;
+                }
+            });
+            logger.info(`Registered MCP tool: ${tool.name}`);
+        });
+        logger.info(`Registered ${tools.length} tools with MCP Server`);
+        // Create stdio transport
+        const transport = new stdio_js_1.StdioServerTransport();
+        // Connect and run
+        await server.connect(transport);
+        logger.info('MCP server connected via stdio and ready for requests');
+    }
+    catch (error) {
+        logger.error('Failed to start MCP server', { error });
+        await gracefulShutdown();
+        process.exit(1);
+    }
+}
+/**
+ * Graceful shutdown handler
+ */
+async function gracefulShutdown() {
+    try {
+        logger.info('Initiating graceful shutdown...');
+        // Give pending operations time to complete
+        await new Promise(resolve => setTimeout(resolve, 1000));
+        // Cleanup cache instances
+        const { CacheService } = await Promise.resolve().then(() => __importStar(require('./utils/cache.js')));
+        const stats = CacheService.getStats();
+        if (stats.instances > 0) {
+            logger.info(`Cleaning up ${stats.instances} cache instances`);
+        }
+        logger.info('Graceful shutdown completed');
+    }
+    catch (error) {
+        logger.error('Error during graceful shutdown', { error });
+    }
+}
+// Install shutdown handlers
+process.on('SIGTERM', async () => {
+    logger.info('SIGTERM received');
+    await gracefulShutdown();
+    process.exit(0);
+});
+process.on('SIGINT', async () => {
+    logger.info('SIGINT received');
+    await gracefulShutdown();
+    process.exit(0);
+});
+// Start the server
+main().catch(async (error) => {
+    logger.error('Unhandled error in main', { error });
+    await gracefulShutdown();
+    process.exit(1);
+});
+//# sourceMappingURL=mcp-stdio-server.js.map

package/dist/mcp-stdio-server.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+declare const app: import("express-serve-static-core").Express;
+export default app;

package/dist/server.js

@@ -0,0 +1,318 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = __importDefault(require("express"));
+const dotenv_1 = __importDefault(require("dotenv"));
+const cors_1 = __importDefault(require("cors"));
+const logger_1 = require("./utils/logger");
+const quickbase_1 = require("./client/quickbase");
+const cache_1 = require("./utils/cache");
+const tools_1 = require("./tools");
+const mcp_1 = require("./mcp");
+// Load environment variables
+dotenv_1.default.config();
+const logger = (0, logger_1.createLogger)('server');
+// Initialize Express app
+const app = (0, express_1.default)();
+app.use(express_1.default.json());
+app.use((0, cors_1.default)());
+// Configuration
+const PORT = process.env.PORT || 3536; // Changed from 3000 to avoid port conflicts
+// Initialize Quickbase client
+let quickbaseClient = null;
+let cacheService = null;
+// Track connector status
+const connectorStatus = {
+    status: 'disconnected',
+    error: null
+};
+// Initialize MCP server and transport
+const mcpServer = (0, mcp_1.createMcpServer)();
+const mcpTransport = (0, mcp_1.createHttpTransport)();
+/**
+ * Initialize Quickbase client from environment variables
+ */
+function initializeClient() {
+    try {
+        // Validate required environment variables
+        const realmHost = process.env.QUICKBASE_REALM_HOST;
+        const userToken = process.env.QUICKBASE_USER_TOKEN;
+        if (!realmHost) {
+            throw new Error('QUICKBASE_REALM_HOST environment variable is required');
+        }
+        if (!userToken) {
+            throw new Error('QUICKBASE_USER_TOKEN environment variable is required');
+        }
+        // Safely parse cache TTL with validation
+        const cacheTtlStr = process.env.QUICKBASE_CACHE_TTL || '3600';
+        const cacheTtl = parseInt(cacheTtlStr, 10);
+        if (isNaN(cacheTtl) || cacheTtl <= 0) {
+            throw new Error(`Invalid QUICKBASE_CACHE_TTL value: ${cacheTtlStr}. Must be a positive integer.`);
+        }
+        const config = {
+            realmHost,
+            userToken,
+            appId: process.env.QUICKBASE_APP_ID,
+            cacheEnabled: process.env.QUICKBASE_CACHE_ENABLED !== 'false',
+            cacheTtl,
+            debug: process.env.DEBUG === 'true'
+        };
+        quickbaseClient = new quickbase_1.QuickbaseClient(config);
+        cacheService = new cache_1.CacheService(config.cacheTtl, config.cacheEnabled);
+        // Initialize MCP tools
+        (0, tools_1.initializeTools)(quickbaseClient, cacheService);
+        // Register tools with MCP server after initialization
+        (0, mcp_1.registerMcpTools)(mcpServer);
+        connectorStatus.status = 'connected';
+        connectorStatus.error = null;
+        logger.info('Quickbase client initialized successfully');
+        logger.info(`Registered tools: ${tools_1.toolRegistry.getToolNames().join(', ')}`);
+    }
+    catch (error) {
+        connectorStatus.status = 'error';
+        connectorStatus.error = error instanceof Error ? error.message : 'Unknown error';
+        logger.error('Failed to initialize Quickbase client', { error });
+    }
+}
+// MCP tool execution endpoint
+app.post('/api/:tool', async (req, res) => {
+    const toolName = req.params.tool;
+    const params = req.body || {};
+    logger.info(`Executing tool: ${toolName}`, { params });
+    if (!quickbaseClient) {
+        return res.status(500).json({
+            success: false,
+            error: {
+                message: 'Quickbase client not initialized',
+                type: 'ConfigurationError'
+            }
+        });
+    }
+    const tool = tools_1.toolRegistry.getTool(toolName);
+    if (!tool) {
+        return res.status(404).json({
+            success: false,
+            error: {
+                message: `Tool ${toolName} not found`,
+                type: 'NotFoundError'
+            }
+        });
+    }
+    try {
+        const result = await tool.execute(params);
+        res.json(result);
+    }
+    catch (error) {
+        logger.error(`Error executing tool ${toolName}`, { error });
+        res.status(500).json({
+            success: false,
+            error: {
+                message: error instanceof Error ? error.message : 'Unknown error',
+                type: error instanceof Error ? error.name : 'UnknownError'
+            }
+        });
+    }
+});
+// MCP batch tool execution
+app.post('/api/batch', async (req, res) => {
+    const requests = req.body.requests || [];
+    if (!Array.isArray(requests) || requests.length === 0) {
+        return res.status(400).json({
+            success: false,
+            error: {
+                message: 'Invalid batch request format',
+                type: 'ValidationError'
+            }
+        });
+    }
+    logger.info(`Executing batch request with ${requests.length} tools`);
+    if (!quickbaseClient) {
+        return res.status(500).json({
+            success: false,
+            error: {
+                message: 'Quickbase client not initialized',
+                type: 'ConfigurationError'
+            }
+        });
+    }
+    try {
+        const results = await Promise.all(requests.map(async (request) => {
+            const tool = tools_1.toolRegistry.getTool(request.tool);
+            if (!tool) {
+                return {
+                    tool: request.tool,
+                    success: false,
+                    error: {
+                        message: `Tool ${request.tool} not found`,
+                        type: 'NotFoundError'
+                    }
+                };
+            }
+            try {
+                const result = await tool.execute(request.params || {});
+                return {
+                    tool: request.tool,
+                    ...result
+                };
+            }
+            catch (error) {
+                return {
+                    tool: request.tool,
+                    success: false,
+                    error: {
+                        message: error instanceof Error ? error.message : 'Unknown error',
+                        type: error instanceof Error ? error.name : 'UnknownError'
+                    }
+                };
+            }
+        }));
+        res.json({
+            success: true,
+            results
+        });
+    }
+    catch (error) {
+        logger.error('Error executing batch request', { error });
+        res.status(500).json({
+            success: false,
+            error: {
+                message: error instanceof Error ? error.message : 'Unknown error',
+                type: error instanceof Error ? error.name : 'UnknownError'
+            }
+        });
+    }
+});
+// MCP schema endpoint
+app.get('/api/schema', (_req, res) => {
+    if (!quickbaseClient) {
+        return res.status(500).json({
+            success: false,
+            error: {
+                message: 'Quickbase client not initialized',
+                type: 'ConfigurationError'
+            }
+        });
+    }
+    const tools = tools_1.toolRegistry.getAllTools().map(tool => ({
+        name: tool.name,
+        description: tool.description,
+        schema: tool.paramSchema
+    }));
+    res.json({
+        success: true,
+        data: {
+            tools
+        }
+    });
+});
+// Status route
+app.get('/status', (_req, res) => {
+    res.json({
+        name: 'Quickbase MCP Server',
+        version: '2.0.0',
+        status: connectorStatus.status,
+        error: connectorStatus.error,
+        tools: quickbaseClient ? tools_1.toolRegistry.getToolNames() : []
+    });
+});
+// MCP Protocol routes
+// POST endpoint for MCP messages
+app.post('/mcp', async (req, res) => {
+    if (!quickbaseClient) {
+        return res.status(500).json({
+            jsonrpc: '2.0',
+            error: {
+                code: -32000,
+                message: 'Quickbase client not initialized'
+            },
+            id: req.body?.id || null
+        });
+    }
+    try {
+        logger.info('Received MCP protocol request');
+        await (0, mcp_1.handleMcpRequest)(mcpServer, mcpTransport, req, res);
+    }
+    catch (error) {
+        logger.error('Error handling MCP protocol request', { error });
+        res.status(500).json({
+            jsonrpc: '2.0',
+            error: {
+                code: -32000,
+                message: error instanceof Error ? error.message : 'Unknown error'
+            },
+            id: req.body?.id || null
+        });
+    }
+});
+// GET endpoint for MCP long-polling notifications
+app.get('/mcp', async (req, res) => {
+    try {
+        logger.info('Received MCP protocol GET request for notifications');
+        res.setHeader('Content-Type', 'text/event-stream');
+        res.setHeader('Cache-Control', 'no-cache');
+        res.setHeader('Connection', 'keep-alive');
+        // Keep connection open for server-sent events
+        const interval = setInterval(() => {
+            res.write(': keepalive\n\n');
+        }, 30000);
+        req.on('close', () => {
+            clearInterval(interval);
+        });
+    }
+    catch (error) {
+        logger.error('Error handling MCP protocol notifications', { error });
+        res.status(500).end();
+    }
+});
+// Start server
+app.listen(PORT, async () => {
+    logger.info(`Quickbase MCP Server v2 server running on port ${PORT}`);
+    // Initialize Quickbase client
+    initializeClient();
+    // Connect the MCP server to its transport
+    try {
+        await mcpServer.connect(mcpTransport);
+        logger.info('MCP server connected successfully');
+    }
+    catch (error) {
+        logger.error('Failed to connect MCP server', { error });
+    }
+});
+// Graceful shutdown handling
+process.on('SIGTERM', () => {
+    logger.info('SIGTERM received, shutting down gracefully');
+    cleanup();
+});
+process.on('SIGINT', () => {
+    logger.info('SIGINT received, shutting down gracefully');
+    cleanup();
+});
+process.on('uncaughtException', (error) => {
+    logger.error('Uncaught exception', { error });
+    cleanup();
+    process.exit(1);
+});
+process.on('unhandledRejection', (reason, promise) => {
+    logger.error('Unhandled rejection', { reason, promise });
+    cleanup();
+    process.exit(1);
+});
+function cleanup() {
+    try {
+        // Close cache connections
+        if (cacheService) {
+            logger.info('Closing cache service');
+            // Note: Cache service cleanup should be implemented if it has cleanup methods
+        }
+        // Close any other resources
+        logger.info('Cleanup completed');
+    }
+    catch (error) {
+        logger.error('Error during cleanup', { error });
+    }
+}
+// Export for testing
+exports.default = app;
+//# sourceMappingURL=server.js.map