mcp-quickbase 2.0.1

package/dist/tools/files/upload_file.js

@@ -0,0 +1,211 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UploadFileTool = void 0;
+const base_1 = require("../base");
+const logger_1 = require("../../utils/logger");
+const file_1 = require("../../utils/file");
+const logger = (0, logger_1.createLogger)('UploadFileTool');
+/**
+ * Tool for uploading a file to a field in a Quickbase record
+ */
+class UploadFileTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = 'upload_file';
+        this.description = 'Uploads a file to a field in a Quickbase record';
+        /**
+         * Parameter schema for upload_file
+         */
+        this.paramSchema = {
+            type: 'object',
+            properties: {
+                table_id: {
+                    type: 'string',
+                    description: 'The ID of the table (must be a file attachment field)'
+                },
+                record_id: {
+                    type: 'string',
+                    description: 'The ID of the record'
+                },
+                field_id: {
+                    type: 'string',
+                    description: 'The ID of the field (must be a file attachment field)'
+                },
+                file_path: {
+                    type: 'string',
+                    description: 'Path to the file to upload'
+                },
+                file_name: {
+                    type: 'string',
+                    description: 'Custom file name (optional, defaults to the original filename)'
+                }
+            },
+            required: ['table_id', 'record_id', 'field_id', 'file_path']
+        };
+    }
+    /**
+     * Run the upload_file tool
+     * @param params Tool parameters
+     * @returns Upload result
+     */
+    async run(params) {
+        const { table_id, record_id, field_id, file_path, file_name } = params;
+        logger.info('Uploading file to Quickbase record', {
+            tableId: table_id,
+            recordId: record_id,
+            fieldId: field_id,
+            filePath: file_path
+        });
+        // Check if the file exists
+        if (!(0, file_1.fileExists)(file_path)) {
+            throw new Error(`File not found: ${file_path}`);
+        }
+        // Get file information
+        const fileInfo = (0, file_1.getFileInfo)(file_path);
+        if (!fileInfo) {
+            throw new Error(`Unable to get file information: ${file_path}`);
+        }
+        // Validate file size (max 100MB)
+        const MAX_FILE_SIZE = 100 * 1024 * 1024; // 100MB
+        if (fileInfo.size > MAX_FILE_SIZE) {
+            throw new Error(`File size ${fileInfo.size} bytes exceeds maximum allowed size of ${MAX_FILE_SIZE} bytes`);
+        }
+        // Secure file path validation - prevent directory traversal attacks
+        const path = await Promise.resolve().then(() => __importStar(require('path')));
+        const fs = await Promise.resolve().then(() => __importStar(require('fs')));
+        // First, validate the input path before any resolution
+        if (!file_path || typeof file_path !== 'string') {
+            throw new Error('Invalid file path: must be a non-empty string');
+        }
+        // Reject obvious traversal attempts immediately
+        if (file_path.includes('..') || file_path.startsWith('/') || file_path.includes('\\')) {
+            throw new Error('Invalid file path: directory traversal detected');
+        }
+        // Define allowed working directory (current directory only)
+        const workingDir = process.cwd();
+        let resolvedPath;
+        try {
+            // Resolve the path relative to working directory
+            resolvedPath = path.resolve(workingDir, file_path);
+        }
+        catch (error) {
+            throw new Error('Invalid file path format');
+        }
+        // Critical security check: ensure resolved path is within working directory
+        if (!resolvedPath.startsWith(workingDir + path.sep) && resolvedPath !== workingDir) {
+            throw new Error('Invalid file path: access outside working directory denied');
+        }
+        // Verify file exists and is readable
+        try {
+            await fs.promises.access(resolvedPath, fs.constants.R_OK);
+        }
+        catch (error) {
+            throw new Error(`File access denied or file does not exist: ${file_path}`);
+        }
+        // Memory-efficient file reading with size validation
+        const CHUNK_SIZE = 1024 * 1024; // 1MB chunks
+        let fileBase64;
+        try {
+            if (fileInfo.size > 10 * 1024 * 1024) { // > 10MB, use streaming
+                logger.debug('Using streaming read for large file', { size: fileInfo.size });
+                // Stream the file in chunks to prevent memory overflow
+                const chunks = [];
+                const readStream = fs.createReadStream(resolvedPath, { highWaterMark: CHUNK_SIZE });
+                for await (const chunk of readStream) {
+                    chunks.push(chunk.toString('base64'));
+                }
+                fileBase64 = chunks.join('');
+            }
+            else {
+                // Small files can be read directly
+                const fileBuffer = (0, file_1.readFileAsBuffer)(file_path);
+                if (!fileBuffer) {
+                    throw new Error(`Unable to read file: ${file_path}`);
+                }
+                fileBase64 = fileBuffer.toString('base64');
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to read file: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+        // Prepare the file upload request
+        const body = {
+            tableId: table_id,
+            recordId: record_id,
+            fieldId: field_id,
+            fileName: file_name || fileInfo.name,
+            contentType: fileInfo.mimeType,
+            fileData: fileBase64
+        };
+        // Upload the file
+        const response = await this.client.request({
+            method: 'POST',
+            path: '/files',
+            body
+        });
+        if (!response.success || !response.data) {
+            logger.error('Failed to upload file', {
+                error: response.error,
+                tableId: table_id,
+                recordId: record_id,
+                fieldId: field_id
+            });
+            throw new Error(response.error?.message || 'Failed to upload file');
+        }
+        const fileData = response.data;
+        logger.info('Successfully uploaded file', {
+            tableId: table_id,
+            recordId: record_id,
+            fieldId: field_id,
+            fileName: file_name || fileInfo.name
+        });
+        return {
+            recordId: record_id,
+            fieldId: field_id,
+            tableId: table_id,
+            fileName: file_name || fileInfo.name,
+            fileSize: fileInfo.size,
+            version: fileData.version || 1,
+            uploadTime: new Date().toISOString()
+        };
+    }
+}
+exports.UploadFileTool = UploadFileTool;
+//# sourceMappingURL=upload_file.js.map

package/dist/tools/files/upload_file.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,18 @@
+import { QuickbaseClient } from '../client/quickbase';
+import { CacheService } from '../utils/cache';
+/**
+ * Initialize all MCP tools and register them with the registry
+ * @param client Quickbase client
+ * @param cacheService Cache service
+ */
+export declare function initializeTools(client: QuickbaseClient, cacheService: CacheService): void;
+export * from './registry';
+export * from './base';
+export * from './test_connection';
+export * from './configure_cache';
+export * from './apps';
+export * from './tables';
+export * from './fields';
+export * from './records';
+export * from './files';
+export * from './reports';

package/dist/tools/index.js

@@ -0,0 +1,65 @@
+"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 });
+exports.initializeTools = initializeTools;
+const registry_1 = require("./registry");
+const test_connection_1 = require("./test_connection");
+const configure_cache_1 = require("./configure_cache");
+const apps_1 = require("./apps");
+const tables_1 = require("./tables");
+const fields_1 = require("./fields");
+const records_1 = require("./records");
+const files_1 = require("./files");
+const reports_1 = require("./reports");
+const logger_1 = require("../utils/logger");
+const logger = (0, logger_1.createLogger)('ToolsInit');
+/**
+ * Initialize all MCP tools and register them with the registry
+ * @param client Quickbase client
+ * @param cacheService Cache service
+ */
+function initializeTools(client, cacheService) {
+    logger.info('Initializing MCP tools');
+    // Register connection tools
+    registry_1.toolRegistry.registerTool(new test_connection_1.TestConnectionTool(client));
+    registry_1.toolRegistry.registerTool(new configure_cache_1.ConfigureCacheTool(client, cacheService));
+    // Register app management tools
+    (0, apps_1.registerAppTools)(client);
+    // Register table operation tools
+    (0, tables_1.registerTableTools)(client);
+    // Register field management tools
+    (0, fields_1.registerFieldTools)(client);
+    // Register record operation tools
+    (0, records_1.registerRecordTools)(client);
+    // Register file operation tools
+    (0, files_1.registerFileTools)(client);
+    // Register report operation tools
+    (0, reports_1.registerReportTools)(client);
+    // Additional tools will be registered here
+    logger.info(`Registered ${registry_1.toolRegistry.getToolCount()} tools`);
+}
+// Export all tools and related types
+__exportStar(require("./registry"), exports);
+__exportStar(require("./base"), exports);
+__exportStar(require("./test_connection"), exports);
+__exportStar(require("./configure_cache"), exports);
+__exportStar(require("./apps"), exports);
+__exportStar(require("./tables"), exports);
+__exportStar(require("./fields"), exports);
+__exportStar(require("./records"), exports);
+__exportStar(require("./files"), exports);
+__exportStar(require("./reports"), exports);
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAoBA,0CA+BC;AAjDD,yCAA0C;AAC1C,uDAAuD;AACvD,uDAAuD;AACvD,iCAA0C;AAC1C,qCAA8C;AAC9C,qCAA8C;AAC9C,uCAAgD;AAChD,mCAA4C;AAC5C,uCAAgD;AAChD,4CAA+C;AAE/C,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,WAAW,CAAC,CAAC;AAEzC;;;;GAIG;AACH,SAAgB,eAAe,CAC7B,MAAuB,EACvB,YAA0B;IAE1B,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAEtC,4BAA4B;IAC5B,uBAAY,CAAC,YAAY,CAAC,IAAI,oCAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,uBAAY,CAAC,YAAY,CAAC,IAAI,oCAAkB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAExE,gCAAgC;IAChC,IAAA,uBAAgB,EAAC,MAAM,CAAC,CAAC;IAEzB,iCAAiC;IACjC,IAAA,2BAAkB,EAAC,MAAM,CAAC,CAAC;IAE3B,kCAAkC;IAClC,IAAA,2BAAkB,EAAC,MAAM,CAAC,CAAC;IAE3B,kCAAkC;IAClC,IAAA,6BAAmB,EAAC,MAAM,CAAC,CAAC;IAE5B,gCAAgC;IAChC,IAAA,yBAAiB,EAAC,MAAM,CAAC,CAAC;IAE1B,kCAAkC;IAClC,IAAA,6BAAmB,EAAC,MAAM,CAAC,CAAC;IAE5B,2CAA2C;IAE3C,MAAM,CAAC,IAAI,CAAC,cAAc,uBAAY,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,qCAAqC;AACrC,6CAA2B;AAC3B,yCAAuB;AACvB,oDAAkC;AAClC,oDAAkC;AAClC,yCAAuB;AACvB,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,4CAA0B"}

package/dist/tools/records/bulk_create_records.d.ts

@@ -0,0 +1,75 @@
+import { BaseTool } from '../base';
+import { QuickbaseClient } from '../../client/quickbase';
+/**
+ * Parameters for bulk_create_records tool
+ */
+export interface BulkCreateRecordsParams {
+    /**
+     * The ID of the table to create records in
+     */
+    table_id: string;
+    /**
+     * Array of record data to insert
+     */
+    records: Record<string, any>[];
+}
+/**
+ * Response from bulk creating records
+ */
+export interface BulkCreateRecordsResult {
+    /**
+     * Array of created record IDs
+     */
+    recordIds: string[];
+    /**
+     * The ID of the table the records were created in
+     */
+    tableId: string;
+    /**
+     * Number of records created
+     */
+    createdCount: number;
+    /**
+     * Creation timestamp
+     */
+    createdTime?: string;
+}
+/**
+ * Tool for creating multiple records in a Quickbase table
+ */
+export declare class BulkCreateRecordsTool extends BaseTool<BulkCreateRecordsParams, BulkCreateRecordsResult> {
+    name: string;
+    description: string;
+    /**
+     * Parameter schema for bulk_create_records
+     */
+    paramSchema: {
+        type: string;
+        properties: {
+            table_id: {
+                type: string;
+                description: string;
+            };
+            records: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    additionalProperties: boolean;
+                };
+            };
+        };
+        required: string[];
+    };
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client: QuickbaseClient);
+    /**
+     * Run the bulk_create_records tool
+     * @param params Tool parameters
+     * @returns Bulk create result
+     */
+    protected run(params: BulkCreateRecordsParams): Promise<BulkCreateRecordsResult>;
+}

package/dist/tools/records/bulk_create_records.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BulkCreateRecordsTool = void 0;
+const base_1 = require("../base");
+const logger_1 = require("../../utils/logger");
+const logger = (0, logger_1.createLogger)('BulkCreateRecordsTool');
+/**
+ * Tool for creating multiple records in a Quickbase table
+ */
+class BulkCreateRecordsTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = 'bulk_create_records';
+        this.description = 'Creates multiple records in a Quickbase table';
+        /**
+         * Parameter schema for bulk_create_records
+         */
+        this.paramSchema = {
+            type: 'object',
+            properties: {
+                table_id: {
+                    type: 'string',
+                    description: 'The ID of the Quickbase table'
+                },
+                records: {
+                    type: 'array',
+                    description: 'Array of record data to insert',
+                    items: {
+                        type: 'object',
+                        additionalProperties: true
+                    }
+                }
+            },
+            required: ['table_id', 'records']
+        };
+    }
+    /**
+     * Run the bulk_create_records tool
+     * @param params Tool parameters
+     * @returns Bulk create result
+     */
+    async run(params) {
+        const { table_id, records } = params;
+        logger.info(`Bulk creating ${records.length} records in Quickbase table`, {
+            tableId: table_id,
+            recordCount: records.length
+        });
+        // Validate records
+        if (!records || !Array.isArray(records) || records.length === 0) {
+            throw new Error('Records array is required and must not be empty');
+        }
+        // Prepare record data
+        const formattedRecords = records.map(record => {
+            const recordData = {};
+            for (const [field, value] of Object.entries(record)) {
+                recordData[field] = { value };
+            }
+            return recordData;
+        });
+        // Prepare request body
+        const body = {
+            to: table_id,
+            data: formattedRecords
+        };
+        // Create the records
+        const response = await this.client.request({
+            method: 'POST',
+            path: '/records',
+            body
+        });
+        if (!response.success || !response.data) {
+            logger.error('Failed to bulk create records', {
+                error: response.error,
+                tableId: table_id
+            });
+            throw new Error(response.error?.message || 'Failed to bulk create records');
+        }
+        const result = response.data;
+        const metadata = result.metadata || {};
+        if (!metadata.createdRecordIds || metadata.createdRecordIds.length === 0) {
+            logger.error('Bulk record creation response missing record IDs', {
+                response: result
+            });
+            throw new Error('Records created but no record IDs were returned');
+        }
+        const recordIds = metadata.createdRecordIds;
+        logger.info(`Successfully created ${recordIds.length} records`, {
+            recordCount: recordIds.length,
+            tableId: table_id
+        });
+        return {
+            recordIds,
+            tableId: table_id,
+            createdCount: recordIds.length,
+            createdTime: new Date().toISOString()
+        };
+    }
+}
+exports.BulkCreateRecordsTool = BulkCreateRecordsTool;
+//# sourceMappingURL=bulk_create_records.js.map

package/dist/tools/records/bulk_create_records.js.map

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

package/dist/tools/records/bulk_update_records.d.ts

@@ -0,0 +1,77 @@
+import { BaseTool } from '../base';
+import { QuickbaseClient } from '../../client/quickbase';
+/**
+ * Parameters for bulk_update_records tool
+ */
+export interface BulkUpdateRecordsParams {
+    /**
+     * The ID of the table containing the records
+     */
+    table_id: string;
+    /**
+     * Array of record data to update (must include record IDs)
+     */
+    records: Array<Record<string, any> & {
+        id: string;
+    }>;
+}
+/**
+ * Response from bulk updating records
+ */
+export interface BulkUpdateRecordsResult {
+    /**
+     * Array of updated record IDs
+     */
+    recordIds: string[];
+    /**
+     * The ID of the table containing the records
+     */
+    tableId: string;
+    /**
+     * Number of records updated
+     */
+    updatedCount: number;
+    /**
+     * Update timestamp
+     */
+    updatedTime?: string;
+}
+/**
+ * Tool for updating multiple records in a Quickbase table
+ */
+export declare class BulkUpdateRecordsTool extends BaseTool<BulkUpdateRecordsParams, BulkUpdateRecordsResult> {
+    name: string;
+    description: string;
+    /**
+     * Parameter schema for bulk_update_records
+     */
+    paramSchema: {
+        type: string;
+        properties: {
+            table_id: {
+                type: string;
+                description: string;
+            };
+            records: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    additionalProperties: boolean;
+                };
+            };
+        };
+        required: string[];
+    };
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client: QuickbaseClient);
+    /**
+     * Run the bulk_update_records tool
+     * @param params Tool parameters
+     * @returns Bulk update result
+     */
+    protected run(params: BulkUpdateRecordsParams): Promise<BulkUpdateRecordsResult>;
+}

package/dist/tools/records/bulk_update_records.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BulkUpdateRecordsTool = void 0;
+const base_1 = require("../base");
+const logger_1 = require("../../utils/logger");
+const logger = (0, logger_1.createLogger)('BulkUpdateRecordsTool');
+/**
+ * Tool for updating multiple records in a Quickbase table
+ */
+class BulkUpdateRecordsTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = 'bulk_update_records';
+        this.description = 'Updates multiple records in a Quickbase table';
+        /**
+         * Parameter schema for bulk_update_records
+         */
+        this.paramSchema = {
+            type: 'object',
+            properties: {
+                table_id: {
+                    type: 'string',
+                    description: 'The ID of the Quickbase table'
+                },
+                records: {
+                    type: 'array',
+                    description: 'Array of record data to update (must include record IDs)',
+                    items: {
+                        type: 'object',
+                        additionalProperties: true
+                    }
+                }
+            },
+            required: ['table_id', 'records']
+        };
+    }
+    /**
+     * Run the bulk_update_records tool
+     * @param params Tool parameters
+     * @returns Bulk update result
+     */
+    async run(params) {
+        const { table_id, records } = params;
+        logger.info(`Bulk updating ${records.length} records in Quickbase table`, {
+            tableId: table_id,
+            recordCount: records.length
+        });
+        // Validate records
+        if (!records || !Array.isArray(records) || records.length === 0) {
+            throw new Error('Records array is required and must not be empty');
+        }
+        // Check if all records have IDs
+        const missingIds = records.some(record => !record.id);
+        if (missingIds) {
+            throw new Error('All records must include an "id" field for bulk updates');
+        }
+        // Prepare record data
+        const formattedRecords = records.map(record => {
+            const { id, ...fields } = record;
+            const recordData = { id };
+            for (const [field, value] of Object.entries(fields)) {
+                recordData[field] = { value };
+            }
+            return recordData;
+        });
+        // Prepare request body
+        const body = {
+            to: table_id,
+            data: formattedRecords
+        };
+        // Update the records
+        const response = await this.client.request({
+            method: 'POST',
+            path: '/records',
+            body
+        });
+        if (!response.success || !response.data) {
+            logger.error('Failed to bulk update records', {
+                error: response.error,
+                tableId: table_id
+            });
+            throw new Error(response.error?.message || 'Failed to bulk update records');
+        }
+        const recordIds = records.map(record => record.id);
+        logger.info(`Successfully updated ${recordIds.length} records`, {
+            recordCount: recordIds.length,
+            tableId: table_id
+        });
+        return {
+            recordIds,
+            tableId: table_id,
+            updatedCount: recordIds.length,
+            updatedTime: new Date().toISOString()
+        };
+    }
+}
+exports.BulkUpdateRecordsTool = BulkUpdateRecordsTool;
+//# sourceMappingURL=bulk_update_records.js.map