mcp-quickbase 2.0.1

package/dist/tools/records/query_records.js

@@ -0,0 +1,261 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryRecordsTool = void 0;
+const base_1 = require("../base");
+const logger_1 = require("../../utils/logger");
+const logger = (0, logger_1.createLogger)('QueryRecordsTool');
+/**
+ * Tool for querying records from a Quickbase table
+ */
+class QueryRecordsTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = 'query_records';
+        this.description = 'Executes a query against a Quickbase table with optional pagination';
+        /**
+         * Parameter schema for query_records
+         */
+        this.paramSchema = {
+            type: 'object',
+            properties: {
+                table_id: {
+                    type: 'string',
+                    description: 'The ID of the Quickbase table'
+                },
+                where: {
+                    type: 'string',
+                    description: 'Query criteria'
+                },
+                select: {
+                    type: 'array',
+                    description: 'Fields to select',
+                    items: {
+                        type: 'string'
+                    }
+                },
+                orderBy: {
+                    type: 'array',
+                    description: 'Fields to order results by',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            fieldId: {
+                                type: 'string'
+                            },
+                            order: {
+                                type: 'string',
+                                enum: ['ASC', 'DESC']
+                            }
+                        }
+                    }
+                },
+                max_records: {
+                    type: 'number',
+                    description: 'Maximum number of records to return when paginating (default: 1000)'
+                },
+                skip: {
+                    type: 'number',
+                    description: 'Number of records to skip'
+                },
+                paginate: {
+                    type: 'boolean',
+                    description: 'Whether to automatically handle pagination for large result sets'
+                },
+                options: {
+                    type: 'object',
+                    description: 'Query options for filtering, ordering, and pagination'
+                }
+            },
+            required: ['table_id']
+        };
+    }
+    /**
+     * Run the query_records tool
+     * @param params Tool parameters
+     * @returns Queried records
+     */
+    async run(params) {
+        const { table_id, where, select, orderBy, max_records = 1000, skip = 0, paginate = false, options } = params;
+        logger.info('Querying records from Quickbase table', {
+            tableId: table_id,
+            maxRecords: max_records,
+            pagination: paginate ? 'enabled' : 'disabled'
+        });
+        // Prepare the query body
+        const body = {
+            from: table_id
+        };
+        // Add where clause if provided
+        if (where) {
+            body.where = where;
+        }
+        // Add select clause if provided
+        if (select && select.length > 0) {
+            body.select = select;
+        }
+        // Add sorting if provided
+        if (orderBy && orderBy.length > 0) {
+            body.sortBy = orderBy;
+        }
+        // Add pagination
+        const limit = parseInt(max_records.toString(), 10);
+        body.options = {
+            skip,
+            top: Math.min(limit, 1000), // API has a limit of 1000 records per request
+            ...(options || {})
+        };
+        // Execute the query
+        const response = await this.client.request({
+            method: 'POST',
+            path: '/records/query',
+            body
+        });
+        if (!response.success || !response.data) {
+            logger.error('Failed to query records', {
+                error: response.error,
+                tableId: table_id
+            });
+            throw new Error(response.error?.message || 'Failed to query records');
+        }
+        // Safely validate response structure
+        if (typeof response.data !== 'object' || response.data === null) {
+            throw new Error('Invalid API response: data is not an object');
+        }
+        const data = response.data;
+        // Validate records array exists
+        if (!Array.isArray(data.data)) {
+            logger.error('Query response missing data array', { data });
+            throw new Error('Query response does not contain records array');
+        }
+        const records = data.data;
+        // Validate and type-cast fields array
+        const fields = Array.isArray(data.fields)
+            ? data.fields
+            : undefined;
+        const metadata = {
+            fields,
+            tableId: table_id,
+            numRecords: records.length,
+            skip
+        };
+        // Handle pagination if enabled and there may be more records
+        let allRecords = [...records];
+        let hasMore = records.length === body.options.top;
+        if (paginate && hasMore && allRecords.length < limit) {
+            logger.info('Paginating query results', {
+                recordsFetched: allRecords.length,
+                limit
+            });
+            let currentSkip = skip + records.length;
+            let iterationCount = 0;
+            const maxIterations = 100; // Circuit breaker: prevent infinite loops
+            const startTime = Date.now();
+            const maxTimeMs = 30000; // 30 second timeout
+            // Continue fetching until we reach the limit or there are no more records
+            while (hasMore && allRecords.length < limit) {
+                // Circuit breaker checks
+                iterationCount++;
+                if (iterationCount > maxIterations) {
+                    logger.error('Pagination circuit breaker: too many iterations', {
+                        iterationCount,
+                        maxIterations,
+                        totalRecords: allRecords.length
+                    });
+                    break;
+                }
+                if (Date.now() - startTime > maxTimeMs) {
+                    logger.error('Pagination circuit breaker: timeout exceeded', {
+                        timeElapsed: Date.now() - startTime,
+                        maxTimeMs,
+                        totalRecords: allRecords.length
+                    });
+                    break;
+                }
+                // Update pagination options
+                body.options.skip = currentSkip;
+                body.options.top = Math.min(limit - allRecords.length, 1000);
+                // Execute next page query
+                const pageResponse = await this.client.request({
+                    method: 'POST',
+                    path: '/records/query',
+                    body
+                });
+                if (!pageResponse.success || !pageResponse.data) {
+                    logger.error('Failed to query additional records', {
+                        error: pageResponse.error,
+                        tableId: table_id,
+                        skip: currentSkip
+                    });
+                    break;
+                }
+                // Safely validate pagination response structure
+                if (typeof pageResponse.data !== 'object' || pageResponse.data === null) {
+                    logger.error('Invalid pagination response: data is not an object');
+                    break;
+                }
+                const pageData = pageResponse.data;
+                // Validate page records array exists
+                if (!Array.isArray(pageData.data)) {
+                    logger.error('Pagination response missing data array', { pageData });
+                    break;
+                }
+                const pageRecords = pageData.data;
+                // Zero progress detection - prevent infinite loops from bad API responses
+                if (pageRecords.length === 0) {
+                    logger.debug('No more records returned, stopping pagination');
+                    hasMore = false;
+                    break;
+                }
+                // Add the new records to our results
+                allRecords = [...allRecords, ...pageRecords];
+                // Validate pagination progress to prevent infinite loops
+                const previousSkip = currentSkip;
+                currentSkip += pageRecords.length;
+                // Anti-bypass check: ensure offset actually advanced
+                if (currentSkip <= previousSkip) {
+                    logger.error('Pagination offset did not advance - potential infinite loop', {
+                        previousSkip,
+                        currentSkip,
+                        recordsReceived: pageRecords.length
+                    });
+                    break;
+                }
+                // Anti-bypass check: ensure we're not receiving the same data
+                if (pageRecords.length === body.options.top &&
+                    allRecords.length + pageRecords.length > limit) {
+                    logger.debug('Truncating final page to respect limit');
+                    const remainingSlots = limit - allRecords.length;
+                    allRecords = [...allRecords, ...pageRecords.slice(0, remainingSlots)];
+                    hasMore = false;
+                    break;
+                }
+                hasMore = pageRecords.length === body.options.top && allRecords.length < limit;
+                logger.debug('Fetched additional records', {
+                    newRecords: pageRecords.length,
+                    totalRecords: allRecords.length,
+                    limit,
+                    currentSkip,
+                    hasMore
+                });
+            }
+            // Update metadata for the complete result set
+            metadata.numRecords = allRecords.length;
+        }
+        logger.info(`Retrieved ${allRecords.length} records from table`, {
+            tableId: table_id,
+            hasMore
+        });
+        return {
+            records: allRecords,
+            totalRecords: allRecords.length,
+            hasMore,
+            metadata
+        };
+    }
+}
+exports.QueryRecordsTool = QueryRecordsTool;
+//# sourceMappingURL=query_records.js.map

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

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

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

@@ -0,0 +1,81 @@
+import { BaseTool } from '../base';
+import { QuickbaseClient } from '../../client/quickbase';
+/**
+ * Parameters for update_record tool
+ */
+export interface UpdateRecordParams {
+    /**
+     * The ID of the table containing the record
+     */
+    table_id: string;
+    /**
+     * The ID of the record to update
+     */
+    record_id: string;
+    /**
+     * The data to update in the record, formatted as a JSON object
+     * with field IDs or field names as keys
+     */
+    data: Record<string, any>;
+}
+/**
+ * Response from updating a record
+ */
+export interface UpdateRecordResult {
+    /**
+     * The ID of the updated record
+     */
+    recordId: string;
+    /**
+     * The ID of the table containing the record
+     */
+    tableId: string;
+    /**
+     * Update timestamp
+     */
+    updatedTime?: string;
+    /**
+     * Fields that were updated
+     */
+    updatedFields?: string[];
+}
+/**
+ * Tool for updating an existing record in a Quickbase table
+ */
+export declare class UpdateRecordTool extends BaseTool<UpdateRecordParams, UpdateRecordResult> {
+    name: string;
+    description: string;
+    /**
+     * Parameter schema for update_record
+     */
+    paramSchema: {
+        type: string;
+        properties: {
+            table_id: {
+                type: string;
+                description: string;
+            };
+            record_id: {
+                type: string;
+                description: string;
+            };
+            data: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+            };
+        };
+        required: string[];
+    };
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client: QuickbaseClient);
+    /**
+     * Run the update_record tool
+     * @param params Tool parameters
+     * @returns Updated record information
+     */
+    protected run(params: UpdateRecordParams): Promise<UpdateRecordResult>;
+}

package/dist/tools/records/update_record.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateRecordTool = void 0;
+const base_1 = require("../base");
+const logger_1 = require("../../utils/logger");
+const logger = (0, logger_1.createLogger)('UpdateRecordTool');
+/**
+ * Tool for updating an existing record in a Quickbase table
+ */
+class UpdateRecordTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = 'update_record';
+        this.description = 'Updates an existing record in a Quickbase table';
+        /**
+         * Parameter schema for update_record
+         */
+        this.paramSchema = {
+            type: 'object',
+            properties: {
+                table_id: {
+                    type: 'string',
+                    description: 'The ID of the Quickbase table'
+                },
+                record_id: {
+                    type: 'string',
+                    description: 'The ID of the record to update'
+                },
+                data: {
+                    type: 'object',
+                    description: 'The updated data for the record',
+                    additionalProperties: true
+                }
+            },
+            required: ['table_id', 'record_id', 'data']
+        };
+    }
+    /**
+     * Run the update_record tool
+     * @param params Tool parameters
+     * @returns Updated record information
+     */
+    async run(params) {
+        const { table_id, record_id, data } = params;
+        logger.info('Updating record in Quickbase table', {
+            tableId: table_id,
+            recordId: record_id
+        });
+        // Validate data
+        if (!data || typeof data !== 'object' || Object.keys(data).length === 0) {
+            throw new Error('Update data is required and must be a non-empty object');
+        }
+        // Prepare record data
+        // Convert data to { [fieldId]: { value: fieldValue } } format expected by the API
+        const recordData = {};
+        for (const [field, value] of Object.entries(data)) {
+            recordData[field] = { value };
+        }
+        // Prepare request body
+        const body = {
+            to: table_id,
+            data: [{
+                    id: record_id,
+                    ...recordData
+                }]
+        };
+        // Update the record
+        const response = await this.client.request({
+            method: 'POST',
+            path: '/records',
+            body
+        });
+        if (!response.success || !response.data) {
+            logger.error('Failed to update record', {
+                error: response.error,
+                tableId: table_id,
+                recordId: record_id
+            });
+            throw new Error(response.error?.message || 'Failed to update record');
+        }
+        logger.info('Successfully updated record', {
+            recordId: record_id,
+            tableId: table_id,
+            updatedFields: Object.keys(data)
+        });
+        return {
+            recordId: record_id,
+            tableId: table_id,
+            updatedTime: new Date().toISOString(),
+            updatedFields: Object.keys(data)
+        };
+    }
+}
+exports.UpdateRecordTool = UpdateRecordTool;
+//# sourceMappingURL=update_record.js.map

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

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,41 @@
+import { McpTool, ToolRegistry } from '../types/mcp';
+/**
+ * Implementation of the MCP Tool Registry
+ * Manages all available MCP tools
+ */
+export declare class ToolRegistryImpl implements ToolRegistry {
+    private tools;
+    /**
+     * Get a tool by name
+     * @param name Tool name
+     * @returns The tool or undefined if not found
+     */
+    getTool(name: string): McpTool<any, any> | undefined;
+    /**
+     * Register a tool
+     * @param tool Tool to register
+     */
+    registerTool<TParams, TResult>(tool: McpTool<TParams, TResult>): void;
+    /**
+     * Get all registered tools
+     * @returns Array of all registered tools
+     */
+    getAllTools(): McpTool<any, any>[];
+    /**
+     * Get tool names
+     * @returns Array of tool names
+     */
+    getToolNames(): string[];
+    /**
+     * Check if a tool exists
+     * @param name Tool name
+     * @returns True if the tool exists
+     */
+    hasTool(name: string): boolean;
+    /**
+     * Get tool count
+     * @returns Number of registered tools
+     */
+    getToolCount(): number;
+}
+export declare const toolRegistry: ToolRegistryImpl;

package/dist/tools/registry.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolRegistry = exports.ToolRegistryImpl = void 0;
+const logger_1 = require("../utils/logger");
+const logger = (0, logger_1.createLogger)('ToolRegistry');
+/**
+ * Implementation of the MCP Tool Registry
+ * Manages all available MCP tools
+ */
+class ToolRegistryImpl {
+    constructor() {
+        this.tools = new Map();
+    }
+    /**
+     * Get a tool by name
+     * @param name Tool name
+     * @returns The tool or undefined if not found
+     */
+    getTool(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * Register a tool
+     * @param tool Tool to register
+     */
+    registerTool(tool) {
+        if (this.tools.has(tool.name)) {
+            logger.warn(`Tool with name ${tool.name} already exists, overwriting`);
+        }
+        this.tools.set(tool.name, tool);
+        logger.info(`Registered tool: ${tool.name}`);
+    }
+    /**
+     * Get all registered tools
+     * @returns Array of all registered tools
+     */
+    getAllTools() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Get tool names
+     * @returns Array of tool names
+     */
+    getToolNames() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+     * Check if a tool exists
+     * @param name Tool name
+     * @returns True if the tool exists
+     */
+    hasTool(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * Get tool count
+     * @returns Number of registered tools
+     */
+    getToolCount() {
+        return this.tools.size;
+    }
+}
+exports.ToolRegistryImpl = ToolRegistryImpl;
+// Create singleton instance
+exports.toolRegistry = new ToolRegistryImpl();
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":";;;AACA,4CAA+C;AAE/C,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,cAAc,CAAC,CAAC;AAE5C;;;GAGG;AACH,MAAa,gBAAgB;IAA7B;QACU,UAAK,GAAmC,IAAI,GAAG,EAAE,CAAC;IAwD5D,CAAC;IAtDC;;;;OAIG;IACI,OAAO,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACI,YAAY,CAAmB,IAA+B;QACnE,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,8BAA8B,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED;;;OAGG;IACI,WAAW;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACI,YAAY;QACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACI,OAAO,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAzDD,4CAyDC;AAED,4BAA4B;AACf,QAAA,YAAY,GAAG,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/tools/reports/index.d.ts

@@ -0,0 +1,6 @@
+import { QuickbaseClient } from '../../client/quickbase';
+/**
+ * Register all report-related tools
+ */
+export declare function registerReportTools(client: QuickbaseClient): void;
+export * from './run_report';

package/dist/tools/reports/index.js

@@ -0,0 +1,31 @@
+"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.registerReportTools = registerReportTools;
+const registry_1 = require("../registry");
+const run_report_1 = require("./run_report");
+const logger_1 = require("../../utils/logger");
+const logger = (0, logger_1.createLogger)('ReportTools');
+/**
+ * Register all report-related tools
+ */
+function registerReportTools(client) {
+    logger.info('Registering report operation tools');
+    registry_1.toolRegistry.registerTool(new run_report_1.RunReportTool(client));
+    logger.info('Report operation tools registered');
+}
+__exportStar(require("./run_report"), exports);
+//# sourceMappingURL=index.js.map

package/dist/tools/reports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/reports/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAUA,kDAMC;AAfD,0CAA2C;AAC3C,6CAA6C;AAC7C,+CAAkD;AAElD,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,aAAa,CAAC,CAAC;AAE3C;;GAEG;AACH,SAAgB,mBAAmB,CAAC,MAAuB;IACzD,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IAElD,uBAAY,CAAC,YAAY,CAAC,IAAI,0BAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IAErD,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;AACnD,CAAC;AAED,+CAA6B"}