@ibm/ibmi-mcp-server 0.2.0 → 0.3.0

package/dist/ibmi-mcp-server/tools/executeSql.tool.js

@@ -0,0 +1,356 @@
+/**
+ * Execute SQL Tool
+ *
+ * Executes SQL queries on IBM i database with optional security restrictions.
+ * Migrated from 3-file pattern to factory pattern.
+ *
+ * @module executeSql.tool
+ * @feature 001-tool-factory
+ */
+import { z } from "zod";
+import { JsonRpcErrorCode, McpError } from "../../types-global/errors.js";
+import { getRequestContext, requestContextService, } from "../../utils/index.js";
+import { logger } from "../../utils/internal/logger.js";
+import { SqlSecurityValidator } from "../utils/security/sqlSecurityValidator.js";
+import { logOperationStart, logOperationSuccess, } from "../../utils/internal/logging-helpers.js";
+import { IBMiConnectionPool } from "../services/connectionPool.js";
+import { defineTool } from "../../mcp-server/tools/utils/tool-factory.js";
+import { config } from "../../config/index.js";
+// =============================================================================
+// Constants & Configuration
+// =============================================================================
+const TOOL_NAME = "execute_sql";
+const TOOL_DESCRIPTION = "Executes a SELECT query on the IBM i database and returns the results. Use this tool to retrieve data from database tables and views.";
+/**
+ * Default tool configuration
+ * Readonly mode is controlled by IBMI_EXECUTE_SQL_READONLY environment variable (defaults to true)
+ * This ensures write operations are opt-in for security
+ */
+let toolConfig = {
+    enabled: true,
+    security: {
+        readOnly: config.ibmi_executeSqlReadonly,
+        maxQueryLength: 10000,
+    },
+};
+/**
+ * Configure the execute SQL tool
+ * @param config - Configuration options
+ */
+export function configureExecuteSqlTool(config) {
+    const context = getRequestContext() ??
+        requestContextService.createRequestContext({
+            operation: "ConfigureExecuteSqlTool",
+        });
+    logOperationStart(context, "Configuring Execute SQL tool", {
+        config,
+        toolName: TOOL_NAME,
+    });
+    // Merge with existing config
+    toolConfig = {
+        ...toolConfig,
+        ...config,
+        security: {
+            ...toolConfig.security,
+            ...config.security,
+        },
+    };
+    logOperationSuccess(context, "Execute SQL tool configuration updated", {
+        enabled: toolConfig.enabled,
+        readOnly: toolConfig.security?.readOnly,
+        maxQueryLength: toolConfig.security?.maxQueryLength,
+    });
+}
+/**
+ * Get the current configuration for the execute SQL tool
+ * @returns Current tool configuration
+ */
+export function getExecuteSqlConfig() {
+    return toolConfig;
+}
+/**
+ * Check if the execute SQL tool is enabled
+ * @returns True if the tool is enabled
+ */
+export function isExecuteSqlEnabled() {
+    return toolConfig.enabled;
+}
+// =============================================================================
+// Schemas
+// =============================================================================
+/**
+ * Input schema for executing SQL queries
+ */
+const ExecuteSqlInputSchema = z.object({
+    sql: z
+        .string()
+        .min(1, "SQL query cannot be empty.")
+        .max(10000, "SQL query exceeds maximum length of 10000 characters.")
+        .describe("The SQL query to execute on the IBM i database."),
+});
+/**
+ * Output schema for SQL execution results
+ */
+const ExecuteSqlResponseSchema = z.object({
+    success: z.boolean().describe("Whether the query executed successfully."),
+    data: z
+        .array(z.record(z.unknown()))
+        .optional()
+        .describe("Array of result rows if query was successful."),
+    rowCount: z
+        .number()
+        .optional()
+        .describe("Number of rows returned by the query."),
+    executionTime: z
+        .number()
+        .optional()
+        .describe("Query execution time in milliseconds."),
+    metadata: z
+        .object({
+        columns: z
+            .array(z.object({
+            name: z.string().describe("Column name"),
+            type: z.string().describe("Column data type"),
+        }))
+            .optional()
+            .describe("Column metadata for the result set."),
+    })
+        .optional()
+        .describe("Additional metadata about the query results."),
+    error: z
+        .object({
+        code: z.string().describe("Error code"),
+        message: z.string().describe("Error message"),
+        details: z.record(z.unknown()).optional().describe("Error details"),
+    })
+        .optional()
+        .describe("Error information if the query failed."),
+});
+// =============================================================================
+// Security Validation
+// =============================================================================
+/**
+ * Validates SQL query against security restrictions
+ * Delegates to centralized SqlSecurityValidator
+ * @param sql - SQL query to validate
+ * @param appContext - Request context for logging
+ * @throws McpError if query violates security restrictions
+ */
+function validateSqlSecurity(sql, appContext) {
+    const config = getExecuteSqlConfig();
+    const securityConfig = {
+        readOnly: config.security?.readOnly ?? true,
+        maxQueryLength: config.security?.maxQueryLength ?? 10000,
+    };
+    // Use centralized validator
+    SqlSecurityValidator.validateQuery(sql, securityConfig, appContext);
+}
+/**
+ * Validate SQL query using IBM i PARSE_STATEMENT
+ * Verifies statement type matches readOnly configuration
+ * Uses IBM i's native SQL parser for authoritative statement type detection
+ *
+ * @param sql - SQL query to validate (should be pre-sanitized without trailing semicolons)
+ * @param readOnly - Whether readonly mode is enabled
+ * @param appContext - Request context for logging
+ * @throws {McpError} If validation fails (syntax error, non-query in readonly mode, or execution failure)
+ *
+ * @see https://www.ibm.com/docs/en/i/7.5?topic=services-parse-statement-table-function
+ */
+async function validateWithParseStatement(sql, readOnly, appContext) {
+    // Build PARSE_STATEMENT query with named parameters
+    const parseQuery = `
+    SELECT DISTINCT SQL_STATEMENT_TYPE
+    FROM TABLE(QSYS2.PARSE_STATEMENT(
+      SQL_STATEMENT => ?,
+      NAMING => '*SQL',
+      DECIMAL_POINT => '*PERIOD',
+      SQL_STRING_DELIMITER => '*APOSTSQL'
+    )) AS P
+  `.trim();
+    try {
+        // Execute PARSE_STATEMENT via connection pool
+        const result = await IBMiConnectionPool.executeQuery(parseQuery, [sql], appContext);
+        // Empty result = syntax error (PARSE_STATEMENT returns no rows on parse failure)
+        if (!result.data || result.data.length === 0) {
+            throw new McpError(JsonRpcErrorCode.ValidationError, "SQL syntax error: Query could not be parsed by IBM i", {
+                query: sql.substring(0, 100) + (sql.length > 100 ? "..." : ""),
+                validationMethod: "parse_statement",
+            });
+        }
+        // Extract statement type from first row
+        const firstRow = result.data[0];
+        const statementType = (firstRow.SQL_STATEMENT_TYPE || "").toUpperCase();
+        // Validate statement type against readOnly mode
+        if (readOnly && statementType !== "QUERY") {
+            throw new McpError(JsonRpcErrorCode.ValidationError, `Non-query statement '${statementType}' not allowed in read-only mode`, {
+                query: sql.substring(0, 100) + (sql.length > 100 ? "..." : ""),
+                sqlStatementType: statementType,
+                readOnly: true,
+                validationMethod: "parse_statement",
+            });
+        }
+        logger.debug({
+            ...appContext,
+            sqlStatementType: statementType,
+            readOnly,
+        }, "PARSE_STATEMENT validation passed");
+    }
+    catch (error) {
+        // Re-throw McpError as-is
+        if (error instanceof McpError) {
+            throw error;
+        }
+        // Fail closed on unexpected errors
+        throw new McpError(JsonRpcErrorCode.ValidationError, "SQL validation failed: Unable to execute PARSE_STATEMENT", {
+            query: sql.substring(0, 100) + (sql.length > 100 ? "..." : ""),
+            validationMethod: "parse_statement",
+            originalError: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+// =============================================================================
+// Business Logic
+// =============================================================================
+/**
+ * Core logic for executing SQL queries
+ * Validates security restrictions and executes the query
+ */
+async function executeSqlLogic(params, appContext, _sdkContext) {
+    // Sanitize SQL: Remove trailing semicolons (statement terminators)
+    // IBM i SQL execution and PARSE_STATEMENT expect pure SQL without terminators
+    const sanitizedSql = params.sql.trim().replace(/;+\s*$/, "");
+    logger.debug({
+        ...appContext,
+        toolInput: params,
+        sanitized: sanitizedSql !== params.sql,
+    }, "Processing execute SQL logic.");
+    const startTime = Date.now();
+    try {
+        // Validate security restrictions (AST/Regex - Layer 1)
+        validateSqlSecurity(sanitizedSql, appContext);
+        // Validate with PARSE_STATEMENT (IBM i native validation - Layer 2)
+        const config = getExecuteSqlConfig();
+        await validateWithParseStatement(sanitizedSql, config.security?.readOnly ?? true, appContext);
+        // Execute the query with sanitized SQL
+        const result = await IBMiConnectionPool.executeQueryWithPagination(sanitizedSql, [], appContext, 1000);
+        const executionTime = Date.now() - startTime;
+        if (!result.success) {
+            // Return error response that matches schema
+            return {
+                success: false,
+                executionTime,
+                error: {
+                    code: String(JsonRpcErrorCode.DatabaseError),
+                    message: "SQL query execution failed",
+                    details: {
+                        sql: sanitizedSql,
+                        sqlReturnCode: result.sql_rc,
+                    },
+                },
+            };
+        }
+        // Type assertion for result data - we know this is an array of records from the database
+        const typedData = result.data;
+        const response = {
+            success: true,
+            data: typedData,
+            rowCount: typedData?.length ?? 0,
+            executionTime,
+            metadata: typedData && typedData.length > 0 && typedData[0]
+                ? {
+                    columns: Object.keys(typedData[0]).map((key) => ({
+                        name: key,
+                        type: typeof typedData[0][key],
+                    })),
+                }
+                : undefined,
+        };
+        logger.debug({
+            ...appContext,
+            rowCount: response.rowCount,
+            executionTime,
+            hasData: !!response.data,
+        }, "SQL query executed successfully.");
+        return response;
+    }
+    catch (error) {
+        const executionTime = Date.now() - startTime;
+        logger.error({
+            ...appContext,
+            error: error instanceof Error ? error.message : String(error),
+            sql: sanitizedSql,
+            executionTime,
+        }, "SQL query execution failed.");
+        // Return error response that matches schema instead of throwing
+        if (error instanceof McpError) {
+            return {
+                success: false,
+                executionTime,
+                error: {
+                    code: String(error.code),
+                    message: error.message,
+                    details: error.details,
+                },
+            };
+        }
+        // Handle unexpected errors
+        return {
+            success: false,
+            executionTime,
+            error: {
+                code: String(JsonRpcErrorCode.DatabaseError),
+                message: `SQL query execution failed: ${error instanceof Error ? error.message : String(error)}`,
+                details: {
+                    sql: sanitizedSql,
+                    originalError: error instanceof Error ? error.name : "Unknown",
+                },
+            },
+        };
+    }
+}
+// =============================================================================
+// Custom Response Formatter
+// =============================================================================
+const executeSqlResponseFormatter = (result) => {
+    if (!result.success) {
+        // Format error response
+        const errorMessage = result.error?.message || "SQL query execution failed";
+        const errorDetails = result.error?.details
+            ? `\n\nDetails:\n${JSON.stringify(result.error.details, null, 2)}`
+            : "";
+        return [
+            {
+                type: "text",
+                text: `Error: ${errorMessage}${errorDetails}`,
+            },
+        ];
+    }
+    // Format the result as a table-like JSON representation
+    const resultJson = JSON.stringify(result.data, null, 2);
+    return [
+        {
+            type: "text",
+            text: `SQL query executed successfully.\n\nRows returned: ${result.rowCount}\nExecution time: ${result.executionTime}ms\n\nResults:\n${resultJson}`,
+        },
+    ];
+};
+// =============================================================================
+// Tool Definition
+// =============================================================================
+export const executeSqlTool = defineTool({
+    name: TOOL_NAME,
+    title: "Execute SQL",
+    description: toolConfig.description || TOOL_DESCRIPTION,
+    inputSchema: ExecuteSqlInputSchema,
+    outputSchema: ExecuteSqlResponseSchema,
+    logic: executeSqlLogic,
+    responseFormatter: executeSqlResponseFormatter,
+    annotations: {
+        readOnlyHint: toolConfig.security?.readOnly ?? true, // Default to true for safety
+        destructiveHint: !(toolConfig.security?.readOnly ?? true), // Destructive if not read-only
+        openWorldHint: !(toolConfig.security?.readOnly ?? true), // Open world if not read-only
+    },
+    enabled: () => toolConfig.enabled, // Use function to dynamically check enabled state
+});
+//# sourceMappingURL=executeSql.tool.js.map

package/dist/ibmi-mcp-server/tools/executeSql.tool.js.map

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

package/dist/ibmi-mcp-server/tools/generateSql.tool.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Generate SQL DDL Tool
+ *
+ * Generates SQL DDL statements for IBM i database objects using the QSYS2.GENERATE_SQL procedure.
+ * Migrated from 3-file pattern to factory pattern.
+ *
+ * @module generateSql.tool
+ * @feature 001-tool-factory
+ */
+import { z } from "zod";
+export declare const generateSqlTool: import("../../mcp-server/tools/utils/types.js").ToolDefinition<{
+    object_name: z.ZodString;
+    object_library: z.ZodDefault<z.ZodString>;
+    object_type: z.ZodDefault<z.ZodEnum<["ALIAS", "CONSTRAINT", "FUNCTION", "INDEX", "MASK", "PERMISSION", "PROCEDURE", "SCHEMA", "SEQUENCE", "TABLE", "TRIGGER", "TYPE", "VARIABLE", "VIEW", "XSR"]>>;
+}, {
+    success: z.ZodBoolean;
+    sql: z.ZodOptional<z.ZodString>;
+    object_name: z.ZodString;
+    object_library: z.ZodString;
+    object_type: z.ZodString;
+    executionTime: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }>>;
+}>;
+//# sourceMappingURL=generateSql.tool.d.ts.map

package/dist/ibmi-mcp-server/tools/generateSql.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateSql.tool.d.ts","sourceRoot":"","sources":["../../../src/ibmi-mcp-server/tools/generateSql.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoUxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;EAc1B,CAAC"}