@neverinfamous/mysql-mcp 2.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.dockerignore +41 -0
- package/.env.example +33 -0
- package/.github/ISSUE_TEMPLATE/bug_report.md +29 -0
- package/.github/ISSUE_TEMPLATE/feature_request.md +21 -0
- package/.github/dependabot.yml +19 -0
- package/.github/pull_request_template.md +23 -0
- package/.github/workflows/codeql.yml +64 -0
- package/.github/workflows/docker-publish.yml +285 -0
- package/.github/workflows/publish-npm.yml +75 -0
- package/CHANGELOG.md +481 -0
- package/CODE_OF_CONDUCT.md +29 -0
- package/CONTRIBUTING.md +57 -0
- package/DOCKER_README.md +482 -0
- package/Dockerfile +78 -0
- package/LICENSE +21 -0
- package/README.md +594 -0
- package/SECURITY.md +66 -0
- package/VERSION +1 -0
- package/dist/__tests__/mocks/adapter.d.ts +80 -0
- package/dist/__tests__/mocks/adapter.d.ts.map +1 -0
- package/dist/__tests__/mocks/adapter.js +202 -0
- package/dist/__tests__/mocks/adapter.js.map +1 -0
- package/dist/__tests__/mocks/index.d.ts +11 -0
- package/dist/__tests__/mocks/index.d.ts.map +1 -0
- package/dist/__tests__/mocks/index.js +11 -0
- package/dist/__tests__/mocks/index.js.map +1 -0
- package/dist/__tests__/mocks/mysql.d.ts +36 -0
- package/dist/__tests__/mocks/mysql.d.ts.map +1 -0
- package/dist/__tests__/mocks/mysql.js +110 -0
- package/dist/__tests__/mocks/mysql.js.map +1 -0
- package/dist/__tests__/setup.d.ts +40 -0
- package/dist/__tests__/setup.d.ts.map +1 -0
- package/dist/__tests__/setup.js +45 -0
- package/dist/__tests__/setup.js.map +1 -0
- package/dist/adapters/DatabaseAdapter.d.ts +134 -0
- package/dist/adapters/DatabaseAdapter.d.ts.map +1 -0
- package/dist/adapters/DatabaseAdapter.js +211 -0
- package/dist/adapters/DatabaseAdapter.js.map +1 -0
- package/dist/adapters/mysql/MySQLAdapter.d.ts +88 -0
- package/dist/adapters/mysql/MySQLAdapter.d.ts.map +1 -0
- package/dist/adapters/mysql/MySQLAdapter.js +469 -0
- package/dist/adapters/mysql/MySQLAdapter.js.map +1 -0
- package/dist/adapters/mysql/SchemaManager.d.ts +36 -0
- package/dist/adapters/mysql/SchemaManager.d.ts.map +1 -0
- package/dist/adapters/mysql/SchemaManager.js +260 -0
- package/dist/adapters/mysql/SchemaManager.js.map +1 -0
- package/dist/adapters/mysql/index.d.ts +6 -0
- package/dist/adapters/mysql/index.d.ts.map +1 -0
- package/dist/adapters/mysql/index.js +7 -0
- package/dist/adapters/mysql/index.js.map +1 -0
- package/dist/adapters/mysql/prompts/backupStrategy.d.ts +8 -0
- package/dist/adapters/mysql/prompts/backupStrategy.d.ts.map +1 -0
- package/dist/adapters/mysql/prompts/backupStrategy.js +74 -0
- package/dist/adapters/mysql/prompts/backupStrategy.js.map +1 -0
- package/dist/adapters/mysql/prompts/clusterSetup.d.ts +8 -0
- package/dist/adapters/mysql/prompts/clusterSetup.d.ts.map +1 -0
- package/dist/adapters/mysql/prompts/clusterSetup.js +112 -0
- package/dist/adapters/mysql/prompts/clusterSetup.js.map +1 -0
- package/dist/adapters/mysql/prompts/docstoreSetup.d.ts +8 -0
- package/dist/adapters/mysql/prompts/docstoreSetup.d.ts.map +1 -0
- package/dist/adapters/mysql/prompts/docstoreSetup.js +117 -0
- package/dist/adapters/mysql/prompts/docstoreSetup.js.map +1 -0
- package/dist/adapters/mysql/prompts/eventScheduler.d.ts +8 -0
- package/dist/adapters/mysql/prompts/eventScheduler.d.ts.map +1 -0
- package/dist/adapters/mysql/prompts/eventScheduler.js +97 -0
- package/dist/adapters/mysql/prompts/eventScheduler.js.map +1 -0
- package/dist/adapters/mysql/prompts/healthCheck.d.ts +8 -0
- package/dist/adapters/mysql/prompts/healthCheck.d.ts.map +1 -0
- package/dist/adapters/mysql/prompts/healthCheck.js +49 -0
- package/dist/adapters/mysql/prompts/healthCheck.js.map +1 -0
- package/dist/adapters/mysql/prompts/index.d.ts +31 -0
- package/dist/adapters/mysql/prompts/index.d.ts.map +1 -0
- package/dist/adapters/mysql/prompts/index.js +308 -0
- package/dist/adapters/mysql/prompts/index.js.map +1 -0
- package/dist/adapters/mysql/prompts/indexTuning.d.ts +8 -0
- package/dist/adapters/mysql/prompts/indexTuning.d.ts.map +1 -0
- package/dist/adapters/mysql/prompts/indexTuning.js +83 -0
- package/dist/adapters/mysql/prompts/indexTuning.js.map +1 -0
- package/dist/adapters/mysql/prompts/mysqlshSetup.d.ts +8 -0
- package/dist/adapters/mysql/prompts/mysqlshSetup.d.ts.map +1 -0
- package/dist/adapters/mysql/prompts/mysqlshSetup.js +113 -0
- package/dist/adapters/mysql/prompts/mysqlshSetup.js.map +1 -0
- package/dist/adapters/mysql/prompts/proxysqlSetup.d.ts +8 -0
- package/dist/adapters/mysql/prompts/proxysqlSetup.d.ts.map +1 -0
- package/dist/adapters/mysql/prompts/proxysqlSetup.js +109 -0
- package/dist/adapters/mysql/prompts/proxysqlSetup.js.map +1 -0
- package/dist/adapters/mysql/prompts/replicationSetup.d.ts +8 -0
- package/dist/adapters/mysql/prompts/replicationSetup.d.ts.map +1 -0
- package/dist/adapters/mysql/prompts/replicationSetup.js +140 -0
- package/dist/adapters/mysql/prompts/replicationSetup.js.map +1 -0
- package/dist/adapters/mysql/prompts/routerSetup.d.ts +8 -0
- package/dist/adapters/mysql/prompts/routerSetup.d.ts.map +1 -0
- package/dist/adapters/mysql/prompts/routerSetup.js +100 -0
- package/dist/adapters/mysql/prompts/routerSetup.js.map +1 -0
- package/dist/adapters/mysql/prompts/spatialSetup.d.ts +8 -0
- package/dist/adapters/mysql/prompts/spatialSetup.d.ts.map +1 -0
- package/dist/adapters/mysql/prompts/spatialSetup.js +103 -0
- package/dist/adapters/mysql/prompts/spatialSetup.js.map +1 -0
- package/dist/adapters/mysql/prompts/sysSchema.d.ts +8 -0
- package/dist/adapters/mysql/prompts/sysSchema.d.ts.map +1 -0
- package/dist/adapters/mysql/prompts/sysSchema.js +103 -0
- package/dist/adapters/mysql/prompts/sysSchema.js.map +1 -0
- package/dist/adapters/mysql/resources/capabilities.d.ts +9 -0
- package/dist/adapters/mysql/resources/capabilities.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/capabilities.js +41 -0
- package/dist/adapters/mysql/resources/capabilities.js.map +1 -0
- package/dist/adapters/mysql/resources/cluster.d.ts +7 -0
- package/dist/adapters/mysql/resources/cluster.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/cluster.js +61 -0
- package/dist/adapters/mysql/resources/cluster.js.map +1 -0
- package/dist/adapters/mysql/resources/docstore.d.ts +7 -0
- package/dist/adapters/mysql/resources/docstore.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/docstore.js +61 -0
- package/dist/adapters/mysql/resources/docstore.js.map +1 -0
- package/dist/adapters/mysql/resources/events.d.ts +7 -0
- package/dist/adapters/mysql/resources/events.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/events.js +41 -0
- package/dist/adapters/mysql/resources/events.js.map +1 -0
- package/dist/adapters/mysql/resources/health.d.ts +10 -0
- package/dist/adapters/mysql/resources/health.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/health.js +76 -0
- package/dist/adapters/mysql/resources/health.js.map +1 -0
- package/dist/adapters/mysql/resources/index.d.ts +29 -0
- package/dist/adapters/mysql/resources/index.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/index.js +66 -0
- package/dist/adapters/mysql/resources/index.js.map +1 -0
- package/dist/adapters/mysql/resources/indexes.d.ts +9 -0
- package/dist/adapters/mysql/resources/indexes.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/indexes.js +88 -0
- package/dist/adapters/mysql/resources/indexes.js.map +1 -0
- package/dist/adapters/mysql/resources/innodb.d.ts +9 -0
- package/dist/adapters/mysql/resources/innodb.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/innodb.js +95 -0
- package/dist/adapters/mysql/resources/innodb.js.map +1 -0
- package/dist/adapters/mysql/resources/locks.d.ts +7 -0
- package/dist/adapters/mysql/resources/locks.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/locks.js +57 -0
- package/dist/adapters/mysql/resources/locks.js.map +1 -0
- package/dist/adapters/mysql/resources/performance.d.ts +9 -0
- package/dist/adapters/mysql/resources/performance.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/performance.js +89 -0
- package/dist/adapters/mysql/resources/performance.js.map +1 -0
- package/dist/adapters/mysql/resources/pool.d.ts +7 -0
- package/dist/adapters/mysql/resources/pool.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/pool.js +21 -0
- package/dist/adapters/mysql/resources/pool.js.map +1 -0
- package/dist/adapters/mysql/resources/processlist.d.ts +7 -0
- package/dist/adapters/mysql/resources/processlist.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/processlist.js +18 -0
- package/dist/adapters/mysql/resources/processlist.js.map +1 -0
- package/dist/adapters/mysql/resources/replication.d.ts +9 -0
- package/dist/adapters/mysql/resources/replication.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/replication.js +116 -0
- package/dist/adapters/mysql/resources/replication.js.map +1 -0
- package/dist/adapters/mysql/resources/schema.d.ts +7 -0
- package/dist/adapters/mysql/resources/schema.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/schema.js +18 -0
- package/dist/adapters/mysql/resources/schema.js.map +1 -0
- package/dist/adapters/mysql/resources/spatial.d.ts +7 -0
- package/dist/adapters/mysql/resources/spatial.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/spatial.js +47 -0
- package/dist/adapters/mysql/resources/spatial.js.map +1 -0
- package/dist/adapters/mysql/resources/status.d.ts +7 -0
- package/dist/adapters/mysql/resources/status.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/status.js +22 -0
- package/dist/adapters/mysql/resources/status.js.map +1 -0
- package/dist/adapters/mysql/resources/sysschema.d.ts +7 -0
- package/dist/adapters/mysql/resources/sysschema.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/sysschema.js +50 -0
- package/dist/adapters/mysql/resources/sysschema.js.map +1 -0
- package/dist/adapters/mysql/resources/tables.d.ts +7 -0
- package/dist/adapters/mysql/resources/tables.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/tables.js +18 -0
- package/dist/adapters/mysql/resources/tables.js.map +1 -0
- package/dist/adapters/mysql/resources/variables.d.ts +7 -0
- package/dist/adapters/mysql/resources/variables.d.ts.map +1 -0
- package/dist/adapters/mysql/resources/variables.js +22 -0
- package/dist/adapters/mysql/resources/variables.js.map +1 -0
- package/dist/adapters/mysql/tools/admin/backup.d.ts +13 -0
- package/dist/adapters/mysql/tools/admin/backup.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/admin/backup.js +208 -0
- package/dist/adapters/mysql/tools/admin/backup.js.map +1 -0
- package/dist/adapters/mysql/tools/admin/index.d.ts +21 -0
- package/dist/adapters/mysql/tools/admin/index.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/admin/index.js +49 -0
- package/dist/adapters/mysql/tools/admin/index.js.map +1 -0
- package/dist/adapters/mysql/tools/admin/maintenance.d.ts +15 -0
- package/dist/adapters/mysql/tools/admin/maintenance.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/admin/maintenance.js +143 -0
- package/dist/adapters/mysql/tools/admin/maintenance.js.map +1 -0
- package/dist/adapters/mysql/tools/admin/monitoring.d.ts +16 -0
- package/dist/adapters/mysql/tools/admin/monitoring.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/admin/monitoring.js +199 -0
- package/dist/adapters/mysql/tools/admin/monitoring.js.map +1 -0
- package/dist/adapters/mysql/tools/cluster/group-replication.d.ts +29 -0
- package/dist/adapters/mysql/tools/cluster/group-replication.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/cluster/group-replication.js +290 -0
- package/dist/adapters/mysql/tools/cluster/group-replication.js.map +1 -0
- package/dist/adapters/mysql/tools/cluster/index.d.ts +13 -0
- package/dist/adapters/mysql/tools/cluster/index.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/cluster/index.js +27 -0
- package/dist/adapters/mysql/tools/cluster/index.js.map +1 -0
- package/dist/adapters/mysql/tools/cluster/innodb-cluster.d.ts +29 -0
- package/dist/adapters/mysql/tools/cluster/innodb-cluster.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/cluster/innodb-cluster.js +351 -0
- package/dist/adapters/mysql/tools/cluster/innodb-cluster.js.map +1 -0
- package/dist/adapters/mysql/tools/core.d.ts +13 -0
- package/dist/adapters/mysql/tools/core.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/core.js +308 -0
- package/dist/adapters/mysql/tools/core.js.map +1 -0
- package/dist/adapters/mysql/tools/docstore.d.ts +10 -0
- package/dist/adapters/mysql/tools/docstore.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/docstore.js +320 -0
- package/dist/adapters/mysql/tools/docstore.js.map +1 -0
- package/dist/adapters/mysql/tools/events.d.ts +13 -0
- package/dist/adapters/mysql/tools/events.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/events.js +367 -0
- package/dist/adapters/mysql/tools/events.js.map +1 -0
- package/dist/adapters/mysql/tools/index.d.ts +25 -0
- package/dist/adapters/mysql/tools/index.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/index.js +43 -0
- package/dist/adapters/mysql/tools/index.js.map +1 -0
- package/dist/adapters/mysql/tools/json/core.d.ts +17 -0
- package/dist/adapters/mysql/tools/json/core.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/json/core.js +264 -0
- package/dist/adapters/mysql/tools/json/core.js.map +1 -0
- package/dist/adapters/mysql/tools/json/enhanced.d.ts +14 -0
- package/dist/adapters/mysql/tools/json/enhanced.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/json/enhanced.js +305 -0
- package/dist/adapters/mysql/tools/json/enhanced.js.map +1 -0
- package/dist/adapters/mysql/tools/json/helpers.d.ts +16 -0
- package/dist/adapters/mysql/tools/json/helpers.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/json/helpers.js +118 -0
- package/dist/adapters/mysql/tools/json/helpers.js.map +1 -0
- package/dist/adapters/mysql/tools/json/index.d.ts +21 -0
- package/dist/adapters/mysql/tools/json/index.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/json/index.js +49 -0
- package/dist/adapters/mysql/tools/json/index.js.map +1 -0
- package/dist/adapters/mysql/tools/partitioning.d.ts +13 -0
- package/dist/adapters/mysql/tools/partitioning.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/partitioning.js +160 -0
- package/dist/adapters/mysql/tools/partitioning.js.map +1 -0
- package/dist/adapters/mysql/tools/performance/analysis.d.ts +17 -0
- package/dist/adapters/mysql/tools/performance/analysis.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/performance/analysis.js +278 -0
- package/dist/adapters/mysql/tools/performance/analysis.js.map +1 -0
- package/dist/adapters/mysql/tools/performance/index.d.ts +17 -0
- package/dist/adapters/mysql/tools/performance/index.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/performance/index.js +36 -0
- package/dist/adapters/mysql/tools/performance/index.js.map +1 -0
- package/dist/adapters/mysql/tools/performance/optimization.d.ts +13 -0
- package/dist/adapters/mysql/tools/performance/optimization.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/performance/optimization.js +187 -0
- package/dist/adapters/mysql/tools/performance/optimization.js.map +1 -0
- package/dist/adapters/mysql/tools/proxysql.d.ts +16 -0
- package/dist/adapters/mysql/tools/proxysql.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/proxysql.js +427 -0
- package/dist/adapters/mysql/tools/proxysql.js.map +1 -0
- package/dist/adapters/mysql/tools/replication.d.ts +13 -0
- package/dist/adapters/mysql/tools/replication.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/replication.js +191 -0
- package/dist/adapters/mysql/tools/replication.js.map +1 -0
- package/dist/adapters/mysql/tools/roles.d.ts +7 -0
- package/dist/adapters/mysql/tools/roles.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/roles.js +190 -0
- package/dist/adapters/mysql/tools/roles.js.map +1 -0
- package/dist/adapters/mysql/tools/router.d.ts +16 -0
- package/dist/adapters/mysql/tools/router.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/router.js +369 -0
- package/dist/adapters/mysql/tools/router.js.map +1 -0
- package/dist/adapters/mysql/tools/schema/constraints.d.ts +7 -0
- package/dist/adapters/mysql/tools/schema/constraints.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/schema/constraints.js +67 -0
- package/dist/adapters/mysql/tools/schema/constraints.js.map +1 -0
- package/dist/adapters/mysql/tools/schema/index.d.ts +12 -0
- package/dist/adapters/mysql/tools/schema/index.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/schema/index.js +29 -0
- package/dist/adapters/mysql/tools/schema/index.js.map +1 -0
- package/dist/adapters/mysql/tools/schema/management.d.ts +15 -0
- package/dist/adapters/mysql/tools/schema/management.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/schema/management.js +113 -0
- package/dist/adapters/mysql/tools/schema/management.js.map +1 -0
- package/dist/adapters/mysql/tools/schema/routines.d.ts +11 -0
- package/dist/adapters/mysql/tools/schema/routines.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/schema/routines.js +98 -0
- package/dist/adapters/mysql/tools/schema/routines.js.map +1 -0
- package/dist/adapters/mysql/tools/schema/scheduled_events.d.ts +7 -0
- package/dist/adapters/mysql/tools/schema/scheduled_events.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/schema/scheduled_events.js +58 -0
- package/dist/adapters/mysql/tools/schema/scheduled_events.js.map +1 -0
- package/dist/adapters/mysql/tools/schema/triggers.d.ts +7 -0
- package/dist/adapters/mysql/tools/schema/triggers.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/schema/triggers.js +49 -0
- package/dist/adapters/mysql/tools/schema/triggers.js.map +1 -0
- package/dist/adapters/mysql/tools/schema/views.d.ts +11 -0
- package/dist/adapters/mysql/tools/schema/views.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/schema/views.js +78 -0
- package/dist/adapters/mysql/tools/schema/views.js.map +1 -0
- package/dist/adapters/mysql/tools/security/audit.d.ts +20 -0
- package/dist/adapters/mysql/tools/security/audit.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/security/audit.js +233 -0
- package/dist/adapters/mysql/tools/security/audit.js.map +1 -0
- package/dist/adapters/mysql/tools/security/data-protection.d.ts +20 -0
- package/dist/adapters/mysql/tools/security/data-protection.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/security/data-protection.js +243 -0
- package/dist/adapters/mysql/tools/security/data-protection.js.map +1 -0
- package/dist/adapters/mysql/tools/security/encryption.d.ts +20 -0
- package/dist/adapters/mysql/tools/security/encryption.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/security/encryption.js +191 -0
- package/dist/adapters/mysql/tools/security/encryption.js.map +1 -0
- package/dist/adapters/mysql/tools/security/index.d.ts +13 -0
- package/dist/adapters/mysql/tools/security/index.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/security/index.js +27 -0
- package/dist/adapters/mysql/tools/security/index.js.map +1 -0
- package/dist/adapters/mysql/tools/shell/backup.d.ts +19 -0
- package/dist/adapters/mysql/tools/shell/backup.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/shell/backup.js +187 -0
- package/dist/adapters/mysql/tools/shell/backup.js.map +1 -0
- package/dist/adapters/mysql/tools/shell/common.d.ts +41 -0
- package/dist/adapters/mysql/tools/shell/common.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/shell/common.js +167 -0
- package/dist/adapters/mysql/tools/shell/common.js.map +1 -0
- package/dist/adapters/mysql/tools/shell/data-transfer.d.ts +19 -0
- package/dist/adapters/mysql/tools/shell/data-transfer.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/shell/data-transfer.js +226 -0
- package/dist/adapters/mysql/tools/shell/data-transfer.js.map +1 -0
- package/dist/adapters/mysql/tools/shell/index.d.ts +17 -0
- package/dist/adapters/mysql/tools/shell/index.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/shell/index.js +34 -0
- package/dist/adapters/mysql/tools/shell/index.js.map +1 -0
- package/dist/adapters/mysql/tools/shell/info.d.ts +11 -0
- package/dist/adapters/mysql/tools/shell/info.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/shell/info.js +40 -0
- package/dist/adapters/mysql/tools/shell/info.js.map +1 -0
- package/dist/adapters/mysql/tools/shell/restore.d.ts +15 -0
- package/dist/adapters/mysql/tools/shell/restore.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/shell/restore.js +135 -0
- package/dist/adapters/mysql/tools/shell/restore.js.map +1 -0
- package/dist/adapters/mysql/tools/shell/utilities.d.ts +11 -0
- package/dist/adapters/mysql/tools/shell/utilities.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/shell/utilities.js +49 -0
- package/dist/adapters/mysql/tools/shell/utilities.js.map +1 -0
- package/dist/adapters/mysql/tools/spatial/geometry.d.ts +17 -0
- package/dist/adapters/mysql/tools/spatial/geometry.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/spatial/geometry.js +87 -0
- package/dist/adapters/mysql/tools/spatial/geometry.js.map +1 -0
- package/dist/adapters/mysql/tools/spatial/index.d.ts +13 -0
- package/dist/adapters/mysql/tools/spatial/index.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/spatial/index.js +31 -0
- package/dist/adapters/mysql/tools/spatial/index.js.map +1 -0
- package/dist/adapters/mysql/tools/spatial/operations.d.ts +25 -0
- package/dist/adapters/mysql/tools/spatial/operations.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/spatial/operations.js +179 -0
- package/dist/adapters/mysql/tools/spatial/operations.js.map +1 -0
- package/dist/adapters/mysql/tools/spatial/queries.d.ts +25 -0
- package/dist/adapters/mysql/tools/spatial/queries.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/spatial/queries.js +205 -0
- package/dist/adapters/mysql/tools/spatial/queries.js.map +1 -0
- package/dist/adapters/mysql/tools/spatial/setup.d.ts +17 -0
- package/dist/adapters/mysql/tools/spatial/setup.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/spatial/setup.js +85 -0
- package/dist/adapters/mysql/tools/spatial/setup.js.map +1 -0
- package/dist/adapters/mysql/tools/stats/comparative.d.ts +21 -0
- package/dist/adapters/mysql/tools/stats/comparative.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/stats/comparative.js +247 -0
- package/dist/adapters/mysql/tools/stats/comparative.js.map +1 -0
- package/dist/adapters/mysql/tools/stats/descriptive.d.ts +30 -0
- package/dist/adapters/mysql/tools/stats/descriptive.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/stats/descriptive.js +403 -0
- package/dist/adapters/mysql/tools/stats/descriptive.js.map +1 -0
- package/dist/adapters/mysql/tools/stats/index.d.ts +13 -0
- package/dist/adapters/mysql/tools/stats/index.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/stats/index.js +25 -0
- package/dist/adapters/mysql/tools/stats/index.js.map +1 -0
- package/dist/adapters/mysql/tools/sysschema/activity.d.ts +17 -0
- package/dist/adapters/mysql/tools/sysschema/activity.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/sysschema/activity.js +107 -0
- package/dist/adapters/mysql/tools/sysschema/activity.js.map +1 -0
- package/dist/adapters/mysql/tools/sysschema/index.d.ts +13 -0
- package/dist/adapters/mysql/tools/sysschema/index.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/sysschema/index.js +26 -0
- package/dist/adapters/mysql/tools/sysschema/index.js.map +1 -0
- package/dist/adapters/mysql/tools/sysschema/performance.d.ts +21 -0
- package/dist/adapters/mysql/tools/sysschema/performance.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/sysschema/performance.js +220 -0
- package/dist/adapters/mysql/tools/sysschema/performance.js.map +1 -0
- package/dist/adapters/mysql/tools/sysschema/resources.d.ts +21 -0
- package/dist/adapters/mysql/tools/sysschema/resources.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/sysschema/resources.js +214 -0
- package/dist/adapters/mysql/tools/sysschema/resources.js.map +1 -0
- package/dist/adapters/mysql/tools/text/fulltext.d.ts +13 -0
- package/dist/adapters/mysql/tools/text/fulltext.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/text/fulltext.js +116 -0
- package/dist/adapters/mysql/tools/text/fulltext.js.map +1 -0
- package/dist/adapters/mysql/tools/text/index.d.ts +17 -0
- package/dist/adapters/mysql/tools/text/index.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/text/index.js +34 -0
- package/dist/adapters/mysql/tools/text/index.js.map +1 -0
- package/dist/adapters/mysql/tools/text/processing.d.ts +15 -0
- package/dist/adapters/mysql/tools/text/processing.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/text/processing.js +203 -0
- package/dist/adapters/mysql/tools/text/processing.js.map +1 -0
- package/dist/adapters/mysql/tools/transactions.d.ts +13 -0
- package/dist/adapters/mysql/tools/transactions.d.ts.map +1 -0
- package/dist/adapters/mysql/tools/transactions.js +224 -0
- package/dist/adapters/mysql/tools/transactions.js.map +1 -0
- package/dist/adapters/mysql/types/proxysql-types.d.ts +156 -0
- package/dist/adapters/mysql/types/proxysql-types.d.ts.map +1 -0
- package/dist/adapters/mysql/types/proxysql-types.js +150 -0
- package/dist/adapters/mysql/types/proxysql-types.js.map +1 -0
- package/dist/adapters/mysql/types/router-types.d.ts +97 -0
- package/dist/adapters/mysql/types/router-types.d.ts.map +1 -0
- package/dist/adapters/mysql/types/router-types.js +89 -0
- package/dist/adapters/mysql/types/router-types.js.map +1 -0
- package/dist/adapters/mysql/types/shell-types.d.ts +109 -0
- package/dist/adapters/mysql/types/shell-types.d.ts.map +1 -0
- package/dist/adapters/mysql/types/shell-types.js +119 -0
- package/dist/adapters/mysql/types/shell-types.js.map +1 -0
- package/dist/adapters/mysql/types.d.ts +257 -0
- package/dist/adapters/mysql/types.d.ts.map +1 -0
- package/dist/adapters/mysql/types.js +245 -0
- package/dist/adapters/mysql/types.js.map +1 -0
- package/dist/auth/AuthorizationServerDiscovery.d.ts +44 -0
- package/dist/auth/AuthorizationServerDiscovery.d.ts.map +1 -0
- package/dist/auth/AuthorizationServerDiscovery.js +110 -0
- package/dist/auth/AuthorizationServerDiscovery.js.map +1 -0
- package/dist/auth/OAuthResourceServer.d.ts +42 -0
- package/dist/auth/OAuthResourceServer.d.ts.map +1 -0
- package/dist/auth/OAuthResourceServer.js +75 -0
- package/dist/auth/OAuthResourceServer.js.map +1 -0
- package/dist/auth/TokenValidator.d.ts +36 -0
- package/dist/auth/TokenValidator.d.ts.map +1 -0
- package/dist/auth/TokenValidator.js +125 -0
- package/dist/auth/TokenValidator.js.map +1 -0
- package/dist/auth/errors.d.ts +63 -0
- package/dist/auth/errors.d.ts.map +1 -0
- package/dist/auth/errors.js +102 -0
- package/dist/auth/errors.js.map +1 -0
- package/dist/auth/index.d.ts +13 -0
- package/dist/auth/index.d.ts.map +1 -0
- package/dist/auth/index.js +15 -0
- package/dist/auth/index.js.map +1 -0
- package/dist/auth/middleware.d.ts +61 -0
- package/dist/auth/middleware.d.ts.map +1 -0
- package/dist/auth/middleware.js +152 -0
- package/dist/auth/middleware.js.map +1 -0
- package/dist/auth/scopes.d.ts +61 -0
- package/dist/auth/scopes.d.ts.map +1 -0
- package/dist/auth/scopes.js +167 -0
- package/dist/auth/scopes.js.map +1 -0
- package/dist/auth/types.d.ts +208 -0
- package/dist/auth/types.d.ts.map +1 -0
- package/dist/auth/types.js +8 -0
- package/dist/auth/types.js.map +1 -0
- package/dist/cli/args.d.ts +15 -0
- package/dist/cli/args.d.ts.map +1 -0
- package/dist/cli/args.js +303 -0
- package/dist/cli/args.js.map +1 -0
- package/dist/cli.d.ts +17 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +141 -0
- package/dist/cli.js.map +1 -0
- package/dist/constants/ServerInstructions.d.ts +17 -0
- package/dist/constants/ServerInstructions.d.ts.map +1 -0
- package/dist/constants/ServerInstructions.js +143 -0
- package/dist/constants/ServerInstructions.js.map +1 -0
- package/dist/filtering/ToolConstants.d.ts +32 -0
- package/dist/filtering/ToolConstants.d.ts.map +1 -0
- package/dist/filtering/ToolConstants.js +290 -0
- package/dist/filtering/ToolConstants.js.map +1 -0
- package/dist/filtering/ToolFilter.d.ts +82 -0
- package/dist/filtering/ToolFilter.d.ts.map +1 -0
- package/dist/filtering/ToolFilter.js +319 -0
- package/dist/filtering/ToolFilter.js.map +1 -0
- package/dist/index.d.ts +15 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +19 -0
- package/dist/index.js.map +1 -0
- package/dist/logging/McpLogging.d.ts +81 -0
- package/dist/logging/McpLogging.d.ts.map +1 -0
- package/dist/logging/McpLogging.js +129 -0
- package/dist/logging/McpLogging.js.map +1 -0
- package/dist/logging/index.d.ts +7 -0
- package/dist/logging/index.d.ts.map +1 -0
- package/dist/logging/index.js +7 -0
- package/dist/logging/index.js.map +1 -0
- package/dist/pool/ConnectionPool.d.ts +76 -0
- package/dist/pool/ConnectionPool.d.ts.map +1 -0
- package/dist/pool/ConnectionPool.js +238 -0
- package/dist/pool/ConnectionPool.js.map +1 -0
- package/dist/progress/ProgressReporter.d.ts +101 -0
- package/dist/progress/ProgressReporter.d.ts.map +1 -0
- package/dist/progress/ProgressReporter.js +153 -0
- package/dist/progress/ProgressReporter.js.map +1 -0
- package/dist/progress/index.d.ts +7 -0
- package/dist/progress/index.d.ts.map +1 -0
- package/dist/progress/index.js +7 -0
- package/dist/progress/index.js.map +1 -0
- package/dist/server/McpServer.d.ts +86 -0
- package/dist/server/McpServer.d.ts.map +1 -0
- package/dist/server/McpServer.js +289 -0
- package/dist/server/McpServer.js.map +1 -0
- package/dist/transports/http.d.ts +74 -0
- package/dist/transports/http.d.ts.map +1 -0
- package/dist/transports/http.js +199 -0
- package/dist/transports/http.js.map +1 -0
- package/dist/transports/index.d.ts +7 -0
- package/dist/transports/index.d.ts.map +1 -0
- package/dist/transports/index.js +7 -0
- package/dist/transports/index.js.map +1 -0
- package/dist/types/index.d.ts +15 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +11 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/modules/database.d.ts +101 -0
- package/dist/types/modules/database.d.ts.map +1 -0
- package/dist/types/modules/database.js +8 -0
- package/dist/types/modules/database.js.map +1 -0
- package/dist/types/modules/errors.d.ts +56 -0
- package/dist/types/modules/errors.d.ts.map +1 -0
- package/dist/types/modules/errors.js +82 -0
- package/dist/types/modules/errors.js.map +1 -0
- package/dist/types/modules/oauth.d.ts +66 -0
- package/dist/types/modules/oauth.d.ts.map +1 -0
- package/dist/types/modules/oauth.js +8 -0
- package/dist/types/modules/oauth.js.map +1 -0
- package/dist/types/modules/query.d.ts +126 -0
- package/dist/types/modules/query.d.ts.map +1 -0
- package/dist/types/modules/query.js +8 -0
- package/dist/types/modules/query.js.map +1 -0
- package/dist/types/modules/server.d.ts +31 -0
- package/dist/types/modules/server.d.ts.map +1 -0
- package/dist/types/modules/server.js +7 -0
- package/dist/types/modules/server.js.map +1 -0
- package/dist/types/modules/tools.d.ts +202 -0
- package/dist/types/modules/tools.d.ts.map +1 -0
- package/dist/types/modules/tools.js +8 -0
- package/dist/types/modules/tools.js.map +1 -0
- package/dist/utils/logger.d.ts +116 -0
- package/dist/utils/logger.d.ts.map +1 -0
- package/dist/utils/logger.js +315 -0
- package/dist/utils/logger.js.map +1 -0
- package/dist/utils/promptGenerator.d.ts +15 -0
- package/dist/utils/promptGenerator.d.ts.map +1 -0
- package/dist/utils/promptGenerator.js +51 -0
- package/dist/utils/promptGenerator.js.map +1 -0
- package/dist/utils/validators.d.ts +59 -0
- package/dist/utils/validators.d.ts.map +1 -0
- package/dist/utils/validators.js +145 -0
- package/dist/utils/validators.js.map +1 -0
- package/eslint.config.js +86 -0
- package/package.json +66 -0
- package/releases/release-notes.md +134 -0
- package/releases/v2.0.0-release-notes.md +522 -0
- package/releases/v2.1.0-release-notes.md +145 -0
- package/server.json +33 -0
- package/src/__tests__/cli.test.ts +304 -0
- package/src/__tests__/index.test.ts +25 -0
- package/src/__tests__/mocks/adapter.ts +265 -0
- package/src/__tests__/mocks/index.ts +36 -0
- package/src/__tests__/mocks/mysql.ts +135 -0
- package/src/__tests__/perf.test.ts +224 -0
- package/src/__tests__/performance.test.ts +181 -0
- package/src/__tests__/setup.ts +55 -0
- package/src/adapters/DatabaseAdapter.ts +376 -0
- package/src/adapters/__tests__/DatabaseAdapter.test.ts +441 -0
- package/src/adapters/mysql/MySQLAdapter.ts +544 -0
- package/src/adapters/mysql/SchemaManager.ts +298 -0
- package/src/adapters/mysql/__tests__/MySQLAdapter.integration.test.ts +155 -0
- package/src/adapters/mysql/__tests__/MySQLAdapter.test.ts +510 -0
- package/src/adapters/mysql/__tests__/SchemaManager.test.ts +165 -0
- package/src/adapters/mysql/index.ts +8 -0
- package/src/adapters/mysql/prompts/__tests__/indexTuning.test.ts +32 -0
- package/src/adapters/mysql/prompts/__tests__/prompts.test.ts +301 -0
- package/src/adapters/mysql/prompts/backupStrategy.ts +81 -0
- package/src/adapters/mysql/prompts/clusterSetup.ts +118 -0
- package/src/adapters/mysql/prompts/docstoreSetup.ts +123 -0
- package/src/adapters/mysql/prompts/eventScheduler.ts +103 -0
- package/src/adapters/mysql/prompts/healthCheck.ts +56 -0
- package/src/adapters/mysql/prompts/index.ts +329 -0
- package/src/adapters/mysql/prompts/indexTuning.ts +90 -0
- package/src/adapters/mysql/prompts/mysqlshSetup.ts +119 -0
- package/src/adapters/mysql/prompts/proxysqlSetup.ts +115 -0
- package/src/adapters/mysql/prompts/replicationSetup.ts +147 -0
- package/src/adapters/mysql/prompts/routerSetup.ts +106 -0
- package/src/adapters/mysql/prompts/spatialSetup.ts +109 -0
- package/src/adapters/mysql/prompts/sysSchema.ts +109 -0
- package/src/adapters/mysql/resources/__tests__/capabilities.test.ts +52 -0
- package/src/adapters/mysql/resources/__tests__/cluster.test.ts +105 -0
- package/src/adapters/mysql/resources/__tests__/docstore.test.ts +97 -0
- package/src/adapters/mysql/resources/__tests__/events.test.ts +97 -0
- package/src/adapters/mysql/resources/__tests__/health.test.ts +92 -0
- package/src/adapters/mysql/resources/__tests__/indexes.test.ts +106 -0
- package/src/adapters/mysql/resources/__tests__/innodb.test.ts +74 -0
- package/src/adapters/mysql/resources/__tests__/locks.test.ts +110 -0
- package/src/adapters/mysql/resources/__tests__/performance.test.ts +60 -0
- package/src/adapters/mysql/resources/__tests__/pool.test.ts +50 -0
- package/src/adapters/mysql/resources/__tests__/processlist.test.ts +29 -0
- package/src/adapters/mysql/resources/__tests__/replication.test.ts +213 -0
- package/src/adapters/mysql/resources/__tests__/resources.test.ts +117 -0
- package/src/adapters/mysql/resources/__tests__/schema.test.ts +30 -0
- package/src/adapters/mysql/resources/__tests__/spatial.test.ts +47 -0
- package/src/adapters/mysql/resources/__tests__/status.test.ts +58 -0
- package/src/adapters/mysql/resources/__tests__/sysschema.test.ts +62 -0
- package/src/adapters/mysql/resources/__tests__/tables.test.ts +37 -0
- package/src/adapters/mysql/resources/__tests__/variables.test.ts +70 -0
- package/src/adapters/mysql/resources/capabilities.ts +51 -0
- package/src/adapters/mysql/resources/cluster.ts +71 -0
- package/src/adapters/mysql/resources/docstore.ts +69 -0
- package/src/adapters/mysql/resources/events.ts +50 -0
- package/src/adapters/mysql/resources/health.ts +96 -0
- package/src/adapters/mysql/resources/index.ts +77 -0
- package/src/adapters/mysql/resources/indexes.ts +98 -0
- package/src/adapters/mysql/resources/innodb.ts +110 -0
- package/src/adapters/mysql/resources/locks.ts +64 -0
- package/src/adapters/mysql/resources/performance.ts +100 -0
- package/src/adapters/mysql/resources/pool.ts +26 -0
- package/src/adapters/mysql/resources/processlist.ts +23 -0
- package/src/adapters/mysql/resources/replication.ts +120 -0
- package/src/adapters/mysql/resources/schema.ts +23 -0
- package/src/adapters/mysql/resources/spatial.ts +54 -0
- package/src/adapters/mysql/resources/status.ts +27 -0
- package/src/adapters/mysql/resources/sysschema.ts +57 -0
- package/src/adapters/mysql/resources/tables.ts +23 -0
- package/src/adapters/mysql/resources/variables.ts +27 -0
- package/src/adapters/mysql/tools/__tests__/cluster.test.ts +349 -0
- package/src/adapters/mysql/tools/__tests__/core.test.ts +439 -0
- package/src/adapters/mysql/tools/__tests__/docstore.test.ts +459 -0
- package/src/adapters/mysql/tools/__tests__/events.test.ts +515 -0
- package/src/adapters/mysql/tools/__tests__/json_core.test.ts +285 -0
- package/src/adapters/mysql/tools/__tests__/json_enhanced.test.ts +380 -0
- package/src/adapters/mysql/tools/__tests__/json_helpers.test.ts +151 -0
- package/src/adapters/mysql/tools/__tests__/proxysql.test.ts +422 -0
- package/src/adapters/mysql/tools/__tests__/replication.test.ts +478 -0
- package/src/adapters/mysql/tools/__tests__/roles.test.ts +217 -0
- package/src/adapters/mysql/tools/__tests__/router.test.ts +603 -0
- package/src/adapters/mysql/tools/__tests__/security.test.ts +466 -0
- package/src/adapters/mysql/tools/__tests__/security_injection.test.ts +188 -0
- package/src/adapters/mysql/tools/__tests__/security_integration.test.ts +223 -0
- package/src/adapters/mysql/tools/__tests__/spatial.test.ts +333 -0
- package/src/adapters/mysql/tools/__tests__/spatial_handler.test.ts +153 -0
- package/src/adapters/mysql/tools/__tests__/stats.test.ts +577 -0
- package/src/adapters/mysql/tools/__tests__/transactions.test.ts +311 -0
- package/src/adapters/mysql/tools/admin/__tests__/backup.test.ts +400 -0
- package/src/adapters/mysql/tools/admin/__tests__/maintenance.test.ts +343 -0
- package/src/adapters/mysql/tools/admin/__tests__/monitoring.test.ts +402 -0
- package/src/adapters/mysql/tools/admin/backup.ts +238 -0
- package/src/adapters/mysql/tools/admin/index.ts +77 -0
- package/src/adapters/mysql/tools/admin/maintenance.ts +160 -0
- package/src/adapters/mysql/tools/admin/monitoring.ts +229 -0
- package/src/adapters/mysql/tools/cluster/__tests__/group-replication.test.ts +204 -0
- package/src/adapters/mysql/tools/cluster/__tests__/innodb-cluster.test.ts +130 -0
- package/src/adapters/mysql/tools/cluster/group-replication.ts +324 -0
- package/src/adapters/mysql/tools/cluster/index.ts +44 -0
- package/src/adapters/mysql/tools/cluster/innodb-cluster.ts +384 -0
- package/src/adapters/mysql/tools/core.ts +363 -0
- package/src/adapters/mysql/tools/docstore.ts +346 -0
- package/src/adapters/mysql/tools/events.ts +419 -0
- package/src/adapters/mysql/tools/index.ts +60 -0
- package/src/adapters/mysql/tools/json/__tests__/core.test.ts +207 -0
- package/src/adapters/mysql/tools/json/__tests__/enhanced.test.ts +316 -0
- package/src/adapters/mysql/tools/json/__tests__/helpers.test.ts +94 -0
- package/src/adapters/mysql/tools/json/__tests__/validation.test.ts +83 -0
- package/src/adapters/mysql/tools/json/core.ts +309 -0
- package/src/adapters/mysql/tools/json/enhanced.ts +346 -0
- package/src/adapters/mysql/tools/json/helpers.ts +137 -0
- package/src/adapters/mysql/tools/json/index.ts +77 -0
- package/src/adapters/mysql/tools/partitioning.ts +184 -0
- package/src/adapters/mysql/tools/performance/__tests__/analysis.test.ts +302 -0
- package/src/adapters/mysql/tools/performance/__tests__/optimization.test.ts +201 -0
- package/src/adapters/mysql/tools/performance/analysis.ts +322 -0
- package/src/adapters/mysql/tools/performance/index.ts +56 -0
- package/src/adapters/mysql/tools/performance/optimization.ts +218 -0
- package/src/adapters/mysql/tools/proxysql.ts +465 -0
- package/src/adapters/mysql/tools/replication.ts +215 -0
- package/src/adapters/mysql/tools/roles.ts +202 -0
- package/src/adapters/mysql/tools/router.ts +405 -0
- package/src/adapters/mysql/tools/schema/__tests__/constraints.test.ts +91 -0
- package/src/adapters/mysql/tools/schema/__tests__/management.test.ts +122 -0
- package/src/adapters/mysql/tools/schema/__tests__/routines.test.ts +45 -0
- package/src/adapters/mysql/tools/schema/__tests__/scheduled_events.test.ts +44 -0
- package/src/adapters/mysql/tools/schema/__tests__/triggers.test.ts +44 -0
- package/src/adapters/mysql/tools/schema/__tests__/views.test.ts +85 -0
- package/src/adapters/mysql/tools/schema/constraints.ts +77 -0
- package/src/adapters/mysql/tools/schema/index.ts +54 -0
- package/src/adapters/mysql/tools/schema/management.ts +131 -0
- package/src/adapters/mysql/tools/schema/routines.ts +106 -0
- package/src/adapters/mysql/tools/schema/scheduled_events.ts +66 -0
- package/src/adapters/mysql/tools/schema/triggers.ts +57 -0
- package/src/adapters/mysql/tools/schema/views.ts +90 -0
- package/src/adapters/mysql/tools/security/__tests__/audit.test.ts +181 -0
- package/src/adapters/mysql/tools/security/__tests__/data-protection.test.ts +111 -0
- package/src/adapters/mysql/tools/security/__tests__/encryption.test.ts +156 -0
- package/src/adapters/mysql/tools/security/audit.ts +272 -0
- package/src/adapters/mysql/tools/security/data-protection.ts +274 -0
- package/src/adapters/mysql/tools/security/encryption.ts +237 -0
- package/src/adapters/mysql/tools/security/index.ts +45 -0
- package/src/adapters/mysql/tools/shell/__tests__/backup.test.ts +298 -0
- package/src/adapters/mysql/tools/shell/__tests__/common.test.ts +180 -0
- package/src/adapters/mysql/tools/shell/__tests__/data-transfer.test.ts +368 -0
- package/src/adapters/mysql/tools/shell/__tests__/info.test.ts +77 -0
- package/src/adapters/mysql/tools/shell/__tests__/restore.test.ts +187 -0
- package/src/adapters/mysql/tools/shell/__tests__/utilities.test.ts +154 -0
- package/src/adapters/mysql/tools/shell/backup.ts +215 -0
- package/src/adapters/mysql/tools/shell/common.ts +227 -0
- package/src/adapters/mysql/tools/shell/data-transfer.ts +256 -0
- package/src/adapters/mysql/tools/shell/index.ts +49 -0
- package/src/adapters/mysql/tools/shell/info.ts +45 -0
- package/src/adapters/mysql/tools/shell/restore.ts +153 -0
- package/src/adapters/mysql/tools/shell/utilities.ts +56 -0
- package/src/adapters/mysql/tools/spatial/__tests__/geometry.test.ts +101 -0
- package/src/adapters/mysql/tools/spatial/__tests__/operations.test.ts +164 -0
- package/src/adapters/mysql/tools/spatial/__tests__/queries.test.ts +253 -0
- package/src/adapters/mysql/tools/spatial/geometry.ts +106 -0
- package/src/adapters/mysql/tools/spatial/index.ts +54 -0
- package/src/adapters/mysql/tools/spatial/operations.ts +217 -0
- package/src/adapters/mysql/tools/spatial/queries.ts +235 -0
- package/src/adapters/mysql/tools/spatial/setup.ts +104 -0
- package/src/adapters/mysql/tools/stats/__tests__/comparative.test.ts +139 -0
- package/src/adapters/mysql/tools/stats/comparative.ts +272 -0
- package/src/adapters/mysql/tools/stats/descriptive.ts +452 -0
- package/src/adapters/mysql/tools/stats/index.ts +40 -0
- package/src/adapters/mysql/tools/sysschema/__tests__/activity.test.ts +89 -0
- package/src/adapters/mysql/tools/sysschema/__tests__/io_summary_fix.test.ts +24 -0
- package/src/adapters/mysql/tools/sysschema/__tests__/performance.test.ts +142 -0
- package/src/adapters/mysql/tools/sysschema/__tests__/resources.test.ts +142 -0
- package/src/adapters/mysql/tools/sysschema/activity.ts +122 -0
- package/src/adapters/mysql/tools/sysschema/index.ts +43 -0
- package/src/adapters/mysql/tools/sysschema/performance.ts +237 -0
- package/src/adapters/mysql/tools/sysschema/resources.ts +232 -0
- package/src/adapters/mysql/tools/text/__tests__/fulltext.test.ts +153 -0
- package/src/adapters/mysql/tools/text/__tests__/processing.test.ts +201 -0
- package/src/adapters/mysql/tools/text/fulltext.ts +140 -0
- package/src/adapters/mysql/tools/text/index.ts +52 -0
- package/src/adapters/mysql/tools/text/processing.ts +242 -0
- package/src/adapters/mysql/tools/transactions.ts +252 -0
- package/src/adapters/mysql/types/__tests__/shell-types.test.ts +210 -0
- package/src/adapters/mysql/types/proxysql-types.ts +190 -0
- package/src/adapters/mysql/types/router-types.ts +129 -0
- package/src/adapters/mysql/types/shell-types.ts +140 -0
- package/src/adapters/mysql/types.ts +298 -0
- package/src/auth/AuthorizationServerDiscovery.ts +133 -0
- package/src/auth/OAuthResourceServer.ts +87 -0
- package/src/auth/TokenValidator.ts +143 -0
- package/src/auth/__tests__/AuthorizationServerDiscovery.test.ts +312 -0
- package/src/auth/__tests__/OAuthResourceServer.test.ts +183 -0
- package/src/auth/__tests__/TokenValidator.test.ts +351 -0
- package/src/auth/__tests__/errors.test.ts +183 -0
- package/src/auth/__tests__/middleware.test.ts +276 -0
- package/src/auth/__tests__/scopes.test.ts +164 -0
- package/src/auth/errors.ts +116 -0
- package/src/auth/index.ts +30 -0
- package/src/auth/middleware.ts +214 -0
- package/src/auth/scopes.ts +193 -0
- package/src/auth/types.ts +303 -0
- package/src/cli/__tests__/args.test.ts +223 -0
- package/src/cli/__tests__/main.test.ts +193 -0
- package/src/cli/args.ts +343 -0
- package/src/cli.ts +168 -0
- package/src/constants/ServerInstructions.ts +159 -0
- package/src/filtering/ToolConstants.ts +297 -0
- package/src/filtering/ToolFilter.ts +363 -0
- package/src/filtering/__tests__/ToolFilter.test.ts +427 -0
- package/src/index.ts +78 -0
- package/src/logging/McpLogging.ts +163 -0
- package/src/logging/__tests__/McpLogging.test.ts +261 -0
- package/src/logging/index.ts +7 -0
- package/src/pool/ConnectionPool.ts +284 -0
- package/src/pool/__tests__/ConnectionPool.test.ts +448 -0
- package/src/progress/ProgressReporter.ts +179 -0
- package/src/progress/__tests__/ProgressReporter.test.ts +263 -0
- package/src/progress/index.ts +7 -0
- package/src/server/McpServer.ts +341 -0
- package/src/server/__tests__/McpServer.test.ts +368 -0
- package/src/transports/__tests__/http.test.ts +596 -0
- package/src/transports/http.ts +248 -0
- package/src/transports/index.ts +7 -0
- package/src/types/__tests__/types.test.ts +201 -0
- package/src/types/index.ts +58 -0
- package/src/types/modules/database.ts +127 -0
- package/src/types/modules/errors.ts +89 -0
- package/src/types/modules/oauth.ts +91 -0
- package/src/types/modules/query.ts +140 -0
- package/src/types/modules/server.ts +39 -0
- package/src/types/modules/tools.ts +296 -0
- package/src/utils/__tests__/logger.test.ts +422 -0
- package/src/utils/__tests__/validators.test.ts +172 -0
- package/src/utils/logger.ts +426 -0
- package/src/utils/promptGenerator.ts +74 -0
- package/src/utils/validators.ts +181 -0
- package/tsconfig.json +51 -0
- package/vitest.config.ts +26 -0
|
@@ -0,0 +1,309 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MySQL JSON Tools - Core Operations
|
|
3
|
+
*
|
|
4
|
+
* Basic JSON operations: extract, set, insert, replace, remove, contains, keys, array append.
|
|
5
|
+
* 8 tools total.
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
import type { MySQLAdapter } from '../../MySQLAdapter.js';
|
|
9
|
+
import type { ToolDefinition, RequestContext } from '../../../../types/index.js';
|
|
10
|
+
import {
|
|
11
|
+
JsonExtractSchema,
|
|
12
|
+
JsonSetSchema,
|
|
13
|
+
JsonContainsSchema,
|
|
14
|
+
JsonKeysSchema
|
|
15
|
+
} from '../../types.js';
|
|
16
|
+
import { z } from 'zod';
|
|
17
|
+
import { validateIdentifier, validateQualifiedIdentifier, validateWhereClause, escapeQualifiedTable } from '../../../../utils/validators.js';
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* Export all core JSON tool creation functions
|
|
21
|
+
*/
|
|
22
|
+
|
|
23
|
+
function validateJsonString(value: unknown): string {
|
|
24
|
+
if (typeof value === 'string') {
|
|
25
|
+
try {
|
|
26
|
+
JSON.parse(value);
|
|
27
|
+
return value;
|
|
28
|
+
} catch {
|
|
29
|
+
throw new Error(`Invalid JSON value. To store a string/text, it must be quoted (e.g., '"my_string"'). Value provided: ${value}`);
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
return JSON.stringify(value);
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
export function createJsonExtractTool(adapter: MySQLAdapter): ToolDefinition {
|
|
36
|
+
return {
|
|
37
|
+
name: 'mysql_json_extract',
|
|
38
|
+
title: 'MySQL JSON Extract',
|
|
39
|
+
description: 'Extract values from JSON columns using JSON path expressions.',
|
|
40
|
+
group: 'json',
|
|
41
|
+
inputSchema: JsonExtractSchema,
|
|
42
|
+
requiredScopes: ['read'],
|
|
43
|
+
annotations: {
|
|
44
|
+
readOnlyHint: true,
|
|
45
|
+
idempotentHint: true
|
|
46
|
+
},
|
|
47
|
+
handler: async (params: unknown, _context: RequestContext) => {
|
|
48
|
+
const { table, column, path, where } = JsonExtractSchema.parse(params);
|
|
49
|
+
|
|
50
|
+
// Validate inputs
|
|
51
|
+
validateQualifiedIdentifier(table, 'table');
|
|
52
|
+
validateIdentifier(column, 'column');
|
|
53
|
+
if (where) {
|
|
54
|
+
validateWhereClause(where);
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
let sql = `SELECT JSON_EXTRACT(\`${column}\`, ?) as extracted_value FROM ${escapeQualifiedTable(table)}`;
|
|
58
|
+
const queryParams: unknown[] = [path];
|
|
59
|
+
|
|
60
|
+
if (where) {
|
|
61
|
+
sql += ` WHERE ${where}`;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
const result = await adapter.executeReadQuery(sql, queryParams);
|
|
65
|
+
return { rows: result.rows };
|
|
66
|
+
}
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
export function createJsonSetTool(adapter: MySQLAdapter): ToolDefinition {
|
|
71
|
+
return {
|
|
72
|
+
name: 'mysql_json_set',
|
|
73
|
+
title: 'MySQL JSON Set',
|
|
74
|
+
description: 'Set or update values in JSON columns at specified paths.',
|
|
75
|
+
group: 'json',
|
|
76
|
+
inputSchema: JsonSetSchema,
|
|
77
|
+
requiredScopes: ['write'],
|
|
78
|
+
annotations: {
|
|
79
|
+
readOnlyHint: false
|
|
80
|
+
},
|
|
81
|
+
handler: async (params: unknown, _context: RequestContext) => {
|
|
82
|
+
const { table, column, path, value, where } = JsonSetSchema.parse(params);
|
|
83
|
+
|
|
84
|
+
// Validate inputs
|
|
85
|
+
validateQualifiedIdentifier(table, 'table');
|
|
86
|
+
validateIdentifier(column, 'column');
|
|
87
|
+
validateWhereClause(where);
|
|
88
|
+
|
|
89
|
+
// Use CAST(? AS JSON) to ensure the value is interpreted as JSON, not as a raw string
|
|
90
|
+
const sql = `UPDATE ${escapeQualifiedTable(table)} SET \`${column}\` = JSON_SET(\`${column}\`, ?, CAST(? AS JSON)) WHERE ${where}`;
|
|
91
|
+
const jsonValue = validateJsonString(value);
|
|
92
|
+
|
|
93
|
+
const result = await adapter.executeWriteQuery(sql, [path, jsonValue]);
|
|
94
|
+
return { rowsAffected: result.rowsAffected };
|
|
95
|
+
}
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
export function createJsonInsertTool(adapter: MySQLAdapter): ToolDefinition {
|
|
100
|
+
const schema = z.object({
|
|
101
|
+
table: z.string(),
|
|
102
|
+
column: z.string(),
|
|
103
|
+
path: z.string(),
|
|
104
|
+
value: z.unknown(),
|
|
105
|
+
where: z.string()
|
|
106
|
+
});
|
|
107
|
+
|
|
108
|
+
return {
|
|
109
|
+
name: 'mysql_json_insert',
|
|
110
|
+
title: 'MySQL JSON Insert',
|
|
111
|
+
description: 'Insert values into JSON columns only if the path does not exist.',
|
|
112
|
+
group: 'json',
|
|
113
|
+
inputSchema: schema,
|
|
114
|
+
requiredScopes: ['write'],
|
|
115
|
+
annotations: {
|
|
116
|
+
readOnlyHint: false
|
|
117
|
+
},
|
|
118
|
+
handler: async (params: unknown, _context: RequestContext) => {
|
|
119
|
+
const { table, column, path, value, where } = schema.parse(params);
|
|
120
|
+
|
|
121
|
+
// Validate inputs
|
|
122
|
+
validateQualifiedIdentifier(table, 'table');
|
|
123
|
+
validateIdentifier(column, 'column');
|
|
124
|
+
validateWhereClause(where);
|
|
125
|
+
|
|
126
|
+
// Use CAST(? AS JSON) to ensure the value is interpreted as JSON, not as a raw string
|
|
127
|
+
const sql = `UPDATE ${escapeQualifiedTable(table)} SET \`${column}\` = JSON_INSERT(\`${column}\`, ?, CAST(? AS JSON)) WHERE ${where}`;
|
|
128
|
+
const jsonValue = validateJsonString(value);
|
|
129
|
+
|
|
130
|
+
const result = await adapter.executeWriteQuery(sql, [path, jsonValue]);
|
|
131
|
+
return { rowsAffected: result.rowsAffected };
|
|
132
|
+
}
|
|
133
|
+
};
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
export function createJsonReplaceTool(adapter: MySQLAdapter): ToolDefinition {
|
|
137
|
+
const schema = z.object({
|
|
138
|
+
table: z.string(),
|
|
139
|
+
column: z.string(),
|
|
140
|
+
path: z.string(),
|
|
141
|
+
value: z.unknown(),
|
|
142
|
+
where: z.string()
|
|
143
|
+
});
|
|
144
|
+
|
|
145
|
+
return {
|
|
146
|
+
name: 'mysql_json_replace',
|
|
147
|
+
title: 'MySQL JSON Replace',
|
|
148
|
+
description: 'Replace values in JSON columns only if the path exists.',
|
|
149
|
+
group: 'json',
|
|
150
|
+
inputSchema: schema,
|
|
151
|
+
requiredScopes: ['write'],
|
|
152
|
+
annotations: {
|
|
153
|
+
readOnlyHint: false
|
|
154
|
+
},
|
|
155
|
+
handler: async (params: unknown, _context: RequestContext) => {
|
|
156
|
+
const { table, column, path, value, where } = schema.parse(params);
|
|
157
|
+
|
|
158
|
+
// Validate inputs
|
|
159
|
+
validateQualifiedIdentifier(table, 'table');
|
|
160
|
+
validateIdentifier(column, 'column');
|
|
161
|
+
validateWhereClause(where);
|
|
162
|
+
|
|
163
|
+
// Use CAST(? AS JSON) to ensure the value is interpreted as JSON, not as a raw string
|
|
164
|
+
const sql = `UPDATE ${escapeQualifiedTable(table)} SET \`${column}\` = JSON_REPLACE(\`${column}\`, ?, CAST(? AS JSON)) WHERE ${where}`;
|
|
165
|
+
const jsonValue = validateJsonString(value);
|
|
166
|
+
|
|
167
|
+
const result = await adapter.executeWriteQuery(sql, [path, jsonValue]);
|
|
168
|
+
return { rowsAffected: result.rowsAffected };
|
|
169
|
+
}
|
|
170
|
+
};
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
export function createJsonRemoveTool(adapter: MySQLAdapter): ToolDefinition {
|
|
174
|
+
const schema = z.object({
|
|
175
|
+
table: z.string(),
|
|
176
|
+
column: z.string(),
|
|
177
|
+
paths: z.array(z.string()),
|
|
178
|
+
where: z.string()
|
|
179
|
+
});
|
|
180
|
+
|
|
181
|
+
return {
|
|
182
|
+
name: 'mysql_json_remove',
|
|
183
|
+
title: 'MySQL JSON Remove',
|
|
184
|
+
description: 'Remove values from JSON columns at specified paths.',
|
|
185
|
+
group: 'json',
|
|
186
|
+
inputSchema: schema,
|
|
187
|
+
requiredScopes: ['write'],
|
|
188
|
+
annotations: {
|
|
189
|
+
readOnlyHint: false
|
|
190
|
+
},
|
|
191
|
+
handler: async (params: unknown, _context: RequestContext) => {
|
|
192
|
+
const { table, column, paths, where } = schema.parse(params);
|
|
193
|
+
|
|
194
|
+
// Validate inputs
|
|
195
|
+
validateQualifiedIdentifier(table, 'table');
|
|
196
|
+
validateIdentifier(column, 'column');
|
|
197
|
+
validateWhereClause(where);
|
|
198
|
+
|
|
199
|
+
const pathPlaceholders = paths.map(() => '?').join(', ');
|
|
200
|
+
const sql = `UPDATE ${escapeQualifiedTable(table)} SET \`${column}\` = JSON_REMOVE(\`${column}\`, ${pathPlaceholders}) WHERE ${where}`;
|
|
201
|
+
|
|
202
|
+
const result = await adapter.executeWriteQuery(sql, paths);
|
|
203
|
+
return { rowsAffected: result.rowsAffected };
|
|
204
|
+
}
|
|
205
|
+
};
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
export function createJsonContainsTool(adapter: MySQLAdapter): ToolDefinition {
|
|
209
|
+
return {
|
|
210
|
+
name: 'mysql_json_contains',
|
|
211
|
+
title: 'MySQL JSON Contains',
|
|
212
|
+
description: 'Find rows where JSON column contains a specified value.',
|
|
213
|
+
group: 'json',
|
|
214
|
+
inputSchema: JsonContainsSchema,
|
|
215
|
+
requiredScopes: ['read'],
|
|
216
|
+
annotations: {
|
|
217
|
+
readOnlyHint: true,
|
|
218
|
+
idempotentHint: true
|
|
219
|
+
},
|
|
220
|
+
handler: async (params: unknown, _context: RequestContext) => {
|
|
221
|
+
const { table, column, value, path } = JsonContainsSchema.parse(params);
|
|
222
|
+
|
|
223
|
+
// Validate inputs
|
|
224
|
+
validateQualifiedIdentifier(table, 'table');
|
|
225
|
+
validateIdentifier(column, 'column');
|
|
226
|
+
|
|
227
|
+
// JSON_CONTAINS expects the value to be a valid JSON document
|
|
228
|
+
// We ensure strict validation so that strings must be quoted (e.g. '"green"')
|
|
229
|
+
const jsonValue = validateJsonString(value);
|
|
230
|
+
let sql: string;
|
|
231
|
+
const queryParams: unknown[] = [jsonValue];
|
|
232
|
+
|
|
233
|
+
if (path) {
|
|
234
|
+
sql = `SELECT * FROM ${escapeQualifiedTable(table)} WHERE JSON_CONTAINS(\`${column}\`, ?, ?)`;
|
|
235
|
+
queryParams.push(path);
|
|
236
|
+
} else {
|
|
237
|
+
sql = `SELECT * FROM ${escapeQualifiedTable(table)} WHERE JSON_CONTAINS(\`${column}\`, ?)`;
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
const result = await adapter.executeReadQuery(sql, queryParams);
|
|
241
|
+
return { rows: result.rows, count: result.rows?.length ?? 0 };
|
|
242
|
+
}
|
|
243
|
+
};
|
|
244
|
+
}
|
|
245
|
+
|
|
246
|
+
export function createJsonKeysTool(adapter: MySQLAdapter): ToolDefinition {
|
|
247
|
+
return {
|
|
248
|
+
name: 'mysql_json_keys',
|
|
249
|
+
title: 'MySQL JSON Keys',
|
|
250
|
+
description: 'Get the keys of a JSON object at the specified path.',
|
|
251
|
+
group: 'json',
|
|
252
|
+
inputSchema: JsonKeysSchema,
|
|
253
|
+
requiredScopes: ['read'],
|
|
254
|
+
annotations: {
|
|
255
|
+
readOnlyHint: true,
|
|
256
|
+
idempotentHint: true
|
|
257
|
+
},
|
|
258
|
+
handler: async (params: unknown, _context: RequestContext) => {
|
|
259
|
+
const { table, column, path } = JsonKeysSchema.parse(params);
|
|
260
|
+
|
|
261
|
+
// Validate inputs
|
|
262
|
+
validateQualifiedIdentifier(table, 'table');
|
|
263
|
+
validateIdentifier(column, 'column');
|
|
264
|
+
|
|
265
|
+
const jsonPath = path ?? '$';
|
|
266
|
+
const sql = `SELECT JSON_KEYS(\`${column}\`, ?) as json_keys FROM ${escapeQualifiedTable(table)}`;
|
|
267
|
+
|
|
268
|
+
const result = await adapter.executeReadQuery(sql, [jsonPath]);
|
|
269
|
+
return { rows: result.rows };
|
|
270
|
+
}
|
|
271
|
+
};
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
export function createJsonArrayAppendTool(adapter: MySQLAdapter): ToolDefinition {
|
|
275
|
+
const schema = z.object({
|
|
276
|
+
table: z.string(),
|
|
277
|
+
column: z.string(),
|
|
278
|
+
path: z.string(),
|
|
279
|
+
value: z.unknown(),
|
|
280
|
+
where: z.string()
|
|
281
|
+
});
|
|
282
|
+
|
|
283
|
+
return {
|
|
284
|
+
name: 'mysql_json_array_append',
|
|
285
|
+
title: 'MySQL JSON Array Append',
|
|
286
|
+
description: 'Append a value to a JSON array at the specified path.',
|
|
287
|
+
group: 'json',
|
|
288
|
+
inputSchema: schema,
|
|
289
|
+
requiredScopes: ['write'],
|
|
290
|
+
annotations: {
|
|
291
|
+
readOnlyHint: false
|
|
292
|
+
},
|
|
293
|
+
handler: async (params: unknown, _context: RequestContext) => {
|
|
294
|
+
const { table, column, path, value, where } = schema.parse(params);
|
|
295
|
+
|
|
296
|
+
// Validate inputs
|
|
297
|
+
validateQualifiedIdentifier(table, 'table');
|
|
298
|
+
validateIdentifier(column, 'column');
|
|
299
|
+
validateWhereClause(where);
|
|
300
|
+
|
|
301
|
+
// Use CAST(? AS JSON) to ensure the value is interpreted as JSON, not as a raw string
|
|
302
|
+
const sql = `UPDATE ${escapeQualifiedTable(table)} SET \`${column}\` = JSON_ARRAY_APPEND(\`${column}\`, ?, CAST(? AS JSON)) WHERE ${where}`;
|
|
303
|
+
const jsonValue = validateJsonString(value);
|
|
304
|
+
|
|
305
|
+
const result = await adapter.executeWriteQuery(sql, [path, jsonValue]);
|
|
306
|
+
return { rowsAffected: result.rowsAffected };
|
|
307
|
+
}
|
|
308
|
+
};
|
|
309
|
+
}
|
|
@@ -0,0 +1,346 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MySQL JSON Tools - Enhanced Operations
|
|
3
|
+
*
|
|
4
|
+
* Advanced JSON tools: merge, diff, normalize, stats, index suggestions.
|
|
5
|
+
* 5 tools total.
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
import type { MySQLAdapter } from '../../MySQLAdapter.js';
|
|
9
|
+
import type { ToolDefinition, RequestContext } from '../../../../types/index.js';
|
|
10
|
+
import { z } from 'zod';
|
|
11
|
+
import { validateQualifiedIdentifier, escapeQualifiedTable, validateIdentifier } from '../../../../utils/validators.js';
|
|
12
|
+
|
|
13
|
+
// =============================================================================
|
|
14
|
+
// Schemas
|
|
15
|
+
// =============================================================================
|
|
16
|
+
|
|
17
|
+
const JsonMergeSchema = z.object({
|
|
18
|
+
json1: z.string().describe('First JSON document'),
|
|
19
|
+
json2: z.string().describe('Second JSON document'),
|
|
20
|
+
mode: z.enum(['patch', 'preserve']).default('patch').describe('Merge mode: patch (RFC 7396) or preserve (array merge)')
|
|
21
|
+
});
|
|
22
|
+
|
|
23
|
+
const JsonDiffSchema = z.object({
|
|
24
|
+
json1: z.string().describe('First JSON document'),
|
|
25
|
+
json2: z.string().describe('Second JSON document')
|
|
26
|
+
});
|
|
27
|
+
|
|
28
|
+
const JsonNormalizeSchema = z.object({
|
|
29
|
+
table: z.string().describe('Table name'),
|
|
30
|
+
column: z.string().describe('JSON column name'),
|
|
31
|
+
where: z.string().optional().describe('WHERE clause'),
|
|
32
|
+
limit: z.number().default(100).describe('Maximum rows to process')
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
const JsonStatsSchema = z.object({
|
|
36
|
+
table: z.string().describe('Table name'),
|
|
37
|
+
column: z.string().describe('JSON column name'),
|
|
38
|
+
where: z.string().optional().describe('Optional WHERE clause'),
|
|
39
|
+
sampleSize: z.number().default(1000).describe('Sample size for statistics')
|
|
40
|
+
});
|
|
41
|
+
|
|
42
|
+
const JsonIndexSuggestSchema = z.object({
|
|
43
|
+
table: z.string().describe('Table name'),
|
|
44
|
+
column: z.string().describe('JSON column name'),
|
|
45
|
+
sampleSize: z.number().default(100).describe('Sample size to analyze')
|
|
46
|
+
});
|
|
47
|
+
|
|
48
|
+
// =============================================================================
|
|
49
|
+
// Tool Creation Functions
|
|
50
|
+
// =============================================================================
|
|
51
|
+
|
|
52
|
+
export function createJsonMergeTool(adapter: MySQLAdapter): ToolDefinition {
|
|
53
|
+
return {
|
|
54
|
+
name: 'mysql_json_merge',
|
|
55
|
+
title: 'MySQL JSON Merge',
|
|
56
|
+
description: 'Merge two JSON documents using JSON_MERGE_PATCH or JSON_MERGE_PRESERVE.',
|
|
57
|
+
group: 'json',
|
|
58
|
+
inputSchema: JsonMergeSchema,
|
|
59
|
+
requiredScopes: ['read'],
|
|
60
|
+
annotations: {
|
|
61
|
+
readOnlyHint: true,
|
|
62
|
+
idempotentHint: true
|
|
63
|
+
},
|
|
64
|
+
handler: async (params: unknown, _context: RequestContext) => {
|
|
65
|
+
const { json1, json2, mode } = JsonMergeSchema.parse(params);
|
|
66
|
+
|
|
67
|
+
const mergeFunction = mode === 'patch' ? 'JSON_MERGE_PATCH' : 'JSON_MERGE_PRESERVE';
|
|
68
|
+
const sql = `SELECT ${mergeFunction}(?, ?) as merged`;
|
|
69
|
+
const result = await adapter.executeReadQuery(sql, [json1, json2]);
|
|
70
|
+
|
|
71
|
+
const merged = result.rows?.[0]?.['merged'];
|
|
72
|
+
return {
|
|
73
|
+
merged: typeof merged === 'string' ? JSON.parse(merged) as Record<string, unknown> : merged,
|
|
74
|
+
mode
|
|
75
|
+
};
|
|
76
|
+
}
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
export function createJsonDiffTool(adapter: MySQLAdapter): ToolDefinition {
|
|
81
|
+
return {
|
|
82
|
+
name: 'mysql_json_diff',
|
|
83
|
+
title: 'MySQL JSON Diff',
|
|
84
|
+
description: 'Compare two JSON documents and identify differences.',
|
|
85
|
+
group: 'json',
|
|
86
|
+
inputSchema: JsonDiffSchema,
|
|
87
|
+
requiredScopes: ['read'],
|
|
88
|
+
annotations: {
|
|
89
|
+
readOnlyHint: true,
|
|
90
|
+
idempotentHint: true
|
|
91
|
+
},
|
|
92
|
+
handler: async (params: unknown, _context: RequestContext) => {
|
|
93
|
+
const { json1, json2 } = JsonDiffSchema.parse(params);
|
|
94
|
+
|
|
95
|
+
// MySQL doesn't have native JSON_DIFF, so we compare key-by-key
|
|
96
|
+
const sql = `
|
|
97
|
+
SELECT
|
|
98
|
+
JSON_CONTAINS(?, ?) as json1_contains_json2,
|
|
99
|
+
JSON_CONTAINS(?, ?) as json2_contains_json1,
|
|
100
|
+
CASE WHEN ? = ? THEN 1 ELSE 0 END as identical,
|
|
101
|
+
JSON_LENGTH(?) as json1_length,
|
|
102
|
+
JSON_LENGTH(?) as json2_length,
|
|
103
|
+
JSON_KEYS(?) as json1_keys,
|
|
104
|
+
JSON_KEYS(?) as json2_keys
|
|
105
|
+
`;
|
|
106
|
+
const result = await adapter.executeReadQuery(sql, [
|
|
107
|
+
json1, json2, json2, json1, json1, json2, json1, json2, json1, json2
|
|
108
|
+
]);
|
|
109
|
+
|
|
110
|
+
const row = result.rows?.[0];
|
|
111
|
+
return {
|
|
112
|
+
identical: row?.['identical'] === 1,
|
|
113
|
+
json1ContainsJson2: row?.['json1_contains_json2'] === 1,
|
|
114
|
+
json2ContainsJson1: row?.['json2_contains_json1'] === 1,
|
|
115
|
+
json1Length: row?.['json1_length'],
|
|
116
|
+
json2Length: row?.['json2_length'],
|
|
117
|
+
json1Keys: typeof row?.['json1_keys'] === 'string'
|
|
118
|
+
? JSON.parse(row['json1_keys']) as string[]
|
|
119
|
+
: row?.['json1_keys'],
|
|
120
|
+
json2Keys: typeof row?.['json2_keys'] === 'string'
|
|
121
|
+
? JSON.parse(row['json2_keys']) as string[]
|
|
122
|
+
: row?.['json2_keys']
|
|
123
|
+
};
|
|
124
|
+
}
|
|
125
|
+
};
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
export function createJsonNormalizeTool(adapter: MySQLAdapter): ToolDefinition {
|
|
129
|
+
return {
|
|
130
|
+
name: 'mysql_json_normalize',
|
|
131
|
+
title: 'MySQL JSON Normalize',
|
|
132
|
+
description: 'Normalize JSON column structure by extracting all unique keys across documents.',
|
|
133
|
+
group: 'json',
|
|
134
|
+
inputSchema: JsonNormalizeSchema,
|
|
135
|
+
requiredScopes: ['read'],
|
|
136
|
+
annotations: {
|
|
137
|
+
readOnlyHint: true,
|
|
138
|
+
idempotentHint: true
|
|
139
|
+
},
|
|
140
|
+
handler: async (params: unknown, _context: RequestContext) => {
|
|
141
|
+
const { table, column, where, limit } = JsonNormalizeSchema.parse(params);
|
|
142
|
+
|
|
143
|
+
// Validate identifiers
|
|
144
|
+
validateQualifiedIdentifier(table, 'table');
|
|
145
|
+
validateIdentifier(column, 'column');
|
|
146
|
+
|
|
147
|
+
const whereClause = where ? `WHERE ${where}` : '';
|
|
148
|
+
|
|
149
|
+
// Get all unique top-level keys
|
|
150
|
+
const keysQuery = `
|
|
151
|
+
SELECT DISTINCT jt.key_name
|
|
152
|
+
FROM ${escapeQualifiedTable(table)},
|
|
153
|
+
JSON_TABLE(
|
|
154
|
+
JSON_KEYS(\`${column}\`),
|
|
155
|
+
'$[*]' COLUMNS (key_name VARCHAR(255) PATH '$')
|
|
156
|
+
) as jt
|
|
157
|
+
${whereClause}
|
|
158
|
+
LIMIT ${String(limit)}
|
|
159
|
+
`;
|
|
160
|
+
|
|
161
|
+
const keysResult = await adapter.executeQuery(keysQuery);
|
|
162
|
+
const uniqueKeys = (keysResult.rows ?? []).map(r => (r)['key_name']);
|
|
163
|
+
|
|
164
|
+
// Get type distribution for each key
|
|
165
|
+
const keyStats: Record<string, unknown>[] = [];
|
|
166
|
+
for (const key of uniqueKeys.slice(0, 20)) { // Limit to 20 keys
|
|
167
|
+
const typeQuery = `
|
|
168
|
+
SELECT
|
|
169
|
+
JSON_TYPE(JSON_EXTRACT(\`${column}\`, CONCAT('$.', ?))) as value_type,
|
|
170
|
+
COUNT(*) as count
|
|
171
|
+
FROM ${escapeQualifiedTable(table)}
|
|
172
|
+
${whereClause}
|
|
173
|
+
GROUP BY value_type
|
|
174
|
+
`;
|
|
175
|
+
const typeResult = await adapter.executeQuery(typeQuery, [key]);
|
|
176
|
+
keyStats.push({
|
|
177
|
+
key,
|
|
178
|
+
types: typeResult.rows ?? []
|
|
179
|
+
});
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
return {
|
|
183
|
+
uniqueKeys,
|
|
184
|
+
keyCount: uniqueKeys.length,
|
|
185
|
+
keyStats,
|
|
186
|
+
truncated: uniqueKeys.length > 20
|
|
187
|
+
};
|
|
188
|
+
}
|
|
189
|
+
};
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
export function createJsonStatsTool(adapter: MySQLAdapter): ToolDefinition {
|
|
193
|
+
return {
|
|
194
|
+
name: 'mysql_json_stats',
|
|
195
|
+
title: 'MySQL JSON Stats',
|
|
196
|
+
description: 'Analyze statistics for a JSON column including depth, size, and key frequency.',
|
|
197
|
+
group: 'json',
|
|
198
|
+
inputSchema: JsonStatsSchema,
|
|
199
|
+
requiredScopes: ['read'],
|
|
200
|
+
annotations: {
|
|
201
|
+
readOnlyHint: true,
|
|
202
|
+
idempotentHint: true
|
|
203
|
+
},
|
|
204
|
+
handler: async (params: unknown, _context: RequestContext) => {
|
|
205
|
+
const { table, column, where, sampleSize } = JsonStatsSchema.parse(params);
|
|
206
|
+
|
|
207
|
+
// Validate identifiers
|
|
208
|
+
validateQualifiedIdentifier(table, 'table');
|
|
209
|
+
validateIdentifier(column, 'column');
|
|
210
|
+
|
|
211
|
+
const whereClause = where ? `WHERE ${where}` : '';
|
|
212
|
+
|
|
213
|
+
const statsQuery = `
|
|
214
|
+
SELECT
|
|
215
|
+
COUNT(*) as total_rows,
|
|
216
|
+
SUM(CASE WHEN \`${column}\` IS NULL THEN 1 ELSE 0 END) as null_count,
|
|
217
|
+
AVG(JSON_LENGTH(\`${column}\`)) as avg_length,
|
|
218
|
+
MAX(JSON_LENGTH(\`${column}\`)) as max_length,
|
|
219
|
+
MIN(JSON_LENGTH(\`${column}\`)) as min_length,
|
|
220
|
+
AVG(JSON_DEPTH(\`${column}\`)) as avg_depth,
|
|
221
|
+
MAX(JSON_DEPTH(\`${column}\`)) as max_depth,
|
|
222
|
+
AVG(LENGTH(\`${column}\`)) as avg_size_bytes,
|
|
223
|
+
MAX(LENGTH(\`${column}\`)) as max_size_bytes
|
|
224
|
+
FROM (SELECT \`${column}\` FROM ${escapeQualifiedTable(table)} ${whereClause} LIMIT ${String(sampleSize)}) as sample
|
|
225
|
+
`;
|
|
226
|
+
|
|
227
|
+
const result = await adapter.executeQuery(statsQuery);
|
|
228
|
+
const row = result.rows?.[0];
|
|
229
|
+
|
|
230
|
+
return {
|
|
231
|
+
totalSampled: row?.['total_rows'],
|
|
232
|
+
nullCount: row?.['null_count'],
|
|
233
|
+
length: {
|
|
234
|
+
avg: row?.['avg_length'],
|
|
235
|
+
max: row?.['max_length'],
|
|
236
|
+
min: row?.['min_length']
|
|
237
|
+
},
|
|
238
|
+
depth: {
|
|
239
|
+
avg: row?.['avg_depth'],
|
|
240
|
+
max: row?.['max_depth']
|
|
241
|
+
},
|
|
242
|
+
sizeBytes: {
|
|
243
|
+
avg: row?.['avg_size_bytes'],
|
|
244
|
+
max: row?.['max_size_bytes']
|
|
245
|
+
},
|
|
246
|
+
sampleSize
|
|
247
|
+
};
|
|
248
|
+
}
|
|
249
|
+
};
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
export function createJsonIndexSuggestTool(adapter: MySQLAdapter): ToolDefinition {
|
|
253
|
+
return {
|
|
254
|
+
name: 'mysql_json_index_suggest',
|
|
255
|
+
title: 'MySQL JSON Index Suggest',
|
|
256
|
+
description: 'Suggest functional indexes for frequently accessed JSON paths.',
|
|
257
|
+
group: 'json',
|
|
258
|
+
inputSchema: JsonIndexSuggestSchema,
|
|
259
|
+
requiredScopes: ['read'],
|
|
260
|
+
annotations: {
|
|
261
|
+
readOnlyHint: true,
|
|
262
|
+
idempotentHint: true
|
|
263
|
+
},
|
|
264
|
+
handler: async (params: unknown, _context: RequestContext) => {
|
|
265
|
+
const { table, column, sampleSize } = JsonIndexSuggestSchema.parse(params);
|
|
266
|
+
|
|
267
|
+
// Validate identifiers
|
|
268
|
+
validateQualifiedIdentifier(table, 'table');
|
|
269
|
+
validateIdentifier(column, 'column');
|
|
270
|
+
|
|
271
|
+
// Get top-level keys and their types
|
|
272
|
+
const keysQuery = `
|
|
273
|
+
SELECT DISTINCT jt.key_name
|
|
274
|
+
FROM ${escapeQualifiedTable(table)},
|
|
275
|
+
JSON_TABLE(
|
|
276
|
+
JSON_KEYS(\`${column}\`),
|
|
277
|
+
'$[*]' COLUMNS (key_name VARCHAR(255) PATH '$')
|
|
278
|
+
) as jt
|
|
279
|
+
LIMIT ${String(sampleSize)}
|
|
280
|
+
`;
|
|
281
|
+
|
|
282
|
+
const keysResult = await adapter.executeQuery(keysQuery);
|
|
283
|
+
const keys = (keysResult.rows ?? []).map(r => (r)['key_name'] as string);
|
|
284
|
+
|
|
285
|
+
// Check cardinality and suggest indexes
|
|
286
|
+
const suggestions: {
|
|
287
|
+
path: string;
|
|
288
|
+
type: string;
|
|
289
|
+
cardinality: number;
|
|
290
|
+
indexDdl: string;
|
|
291
|
+
}[] = [];
|
|
292
|
+
|
|
293
|
+
for (const key of keys.slice(0, 10)) { // Analyze top 10 keys
|
|
294
|
+
// Use standard SQL structure for strict FULL_GROUP_BY compliance
|
|
295
|
+
const cardQuery = `
|
|
296
|
+
SELECT
|
|
297
|
+
t.value_type,
|
|
298
|
+
COUNT(DISTINCT t.val) as cardinality
|
|
299
|
+
FROM (
|
|
300
|
+
SELECT
|
|
301
|
+
JSON_TYPE(JSON_EXTRACT(\`sub\`.\`${column}\`, CONCAT('$.', ?))) as value_type,
|
|
302
|
+
JSON_EXTRACT(\`sub\`.\`${column}\`, CONCAT('$.', ?)) as val
|
|
303
|
+
FROM (
|
|
304
|
+
SELECT \`${column}\`
|
|
305
|
+
FROM ${escapeQualifiedTable(table)}
|
|
306
|
+
LIMIT ${String(sampleSize)}
|
|
307
|
+
) as sub
|
|
308
|
+
WHERE JSON_EXTRACT(\`sub\`.\`${column}\`, CONCAT('$.', ?)) IS NOT NULL
|
|
309
|
+
) as t
|
|
310
|
+
GROUP BY t.value_type
|
|
311
|
+
ORDER BY cardinality DESC
|
|
312
|
+
LIMIT 1
|
|
313
|
+
`;
|
|
314
|
+
const cardResult = await adapter.executeQuery(cardQuery, [key, key, key]);
|
|
315
|
+
const cardRow = cardResult.rows?.[0];
|
|
316
|
+
|
|
317
|
+
const valueType = cardRow?.['value_type'] as string | undefined;
|
|
318
|
+
const cardinality = Number(cardRow?.['cardinality'] ?? 0);
|
|
319
|
+
|
|
320
|
+
if (cardinality > 1) {
|
|
321
|
+
let dataType = 'VARCHAR(255)';
|
|
322
|
+
if (valueType === 'INTEGER') dataType = 'BIGINT';
|
|
323
|
+
else if (valueType === 'DOUBLE') dataType = 'DOUBLE';
|
|
324
|
+
else if (valueType === 'BOOLEAN') dataType = 'TINYINT(1)';
|
|
325
|
+
|
|
326
|
+
suggestions.push({
|
|
327
|
+
path: `$.${key}`,
|
|
328
|
+
type: valueType ?? 'UNKNOWN',
|
|
329
|
+
cardinality,
|
|
330
|
+
indexDdl: `ALTER TABLE \`${table}\` ADD INDEX idx_${table}_${key} ((CAST(JSON_EXTRACT(\`${column}\`, '$.${key}') AS ${dataType})));`
|
|
331
|
+
});
|
|
332
|
+
}
|
|
333
|
+
}
|
|
334
|
+
|
|
335
|
+
// Sort by cardinality (higher is better for indexing)
|
|
336
|
+
suggestions.sort((a, b) => b.cardinality - a.cardinality);
|
|
337
|
+
|
|
338
|
+
return {
|
|
339
|
+
table,
|
|
340
|
+
column,
|
|
341
|
+
suggestions: suggestions.slice(0, 5), // Top 5 suggestions
|
|
342
|
+
note: 'Indexes on high-cardinality paths provide the most benefit. Consider query patterns when creating indexes.'
|
|
343
|
+
};
|
|
344
|
+
}
|
|
345
|
+
};
|
|
346
|
+
}
|