mysql-db-mcp 0.1.0

package/README.md

@@ -0,0 +1,374 @@
+# mysql-db-mcp
+
+A secure MySQL database MCP Server for reading schemas, tables, columns, running SELECT queries, running EXPLAIN, and optionally performing structured inserts and controlled table DDL.
+
+The default mode is read-only:
+
+```bash
+MYSQL_ENABLE_WRITE=false
+MYSQL_ENABLE_DDL=false
+```
+
+No arbitrary `execute_sql`, `execute_write`, or `execute_ddl` tool is provided. Write and DDL operations are only available through structured tool parameters, so identifiers can be validated, values can use MySQL parameter binding, and high-risk operations can require explicit confirmation.
+
+## Tools
+
+Read-only tools enabled by default:
+
+- `list_schemas`
+- `list_tables`
+- `describe_table`
+- `query_select`
+- `explain_select`
+
+Write tools disabled by default:
+
+- `insert_row`
+- `insert_rows`
+
+DDL tools disabled by default:
+
+- `alter_table_add_column`
+- `alter_table_modify_column`
+- `alter_table_drop_column`
+- `alter_table_rename_column`
+- `alter_table_add_index`
+- `alter_table_drop_index`
+
+## Environment Variables
+
+| Variable | Default | Description |
+| --- | --- | --- |
+| `MYSQL_HOST` | `127.0.0.1` | MySQL host |
+| `MYSQL_PORT` | `3306` | MySQL port |
+| `MYSQL_USER` | `root` | MySQL user |
+| `MYSQL_PASSWORD` | empty | MySQL password |
+| `MYSQL_DATABASE` | unset | Default schema |
+| `MYSQL_SSL` | `false` | Enable mysql2 SSL option |
+| `MYSQL_CONNECTION_LIMIT` | `10` | Pool connection limit |
+| `MYSQL_MAX_ROWS` | `200` | Maximum returned SELECT rows |
+| `MYSQL_ENABLE_WRITE` | `false` | Enables `insert_row` and `insert_rows` |
+| `MYSQL_ENABLE_DDL` | `false` | Enables controlled ALTER TABLE tools |
+| `MYSQL_WRITE_ALLOWED_SCHEMAS` | unset | Comma-separated schemas allowed for writes |
+| `MYSQL_WRITE_ALLOWED_TABLES` | unset | Comma-separated tables allowed for writes |
+| `MYSQL_DDL_ALLOWED_SCHEMAS` | unset | Comma-separated schemas allowed for DDL |
+| `MYSQL_DDL_ALLOWED_TABLES` | unset | Comma-separated tables allowed for DDL |
+| `MYSQL_BLOCKED_TABLES` | unset | Extra comma-separated blocked tables |
+| `MYSQL_MAX_INSERT_ROWS` | `100` | Max rows for `insert_rows` |
+| `MYSQL_REQUIRE_CONFIRMATION` | `true` | Requires `confirm: true` for write and DDL tools |
+
+System schemas are always blocked: `mysql`, `information_schema`, `performance_schema`, and `sys`.
+
+## Install And Run
+
+```bash
+mkdir mysql-db-mcp
+cd mysql-db-mcp
+npm install
+npm run build
+npm link
+mysql-db-mcp
+```
+
+For local development:
+
+```bash
+npm run dev
+```
+
+After publishing to npm, users can start it with:
+
+```bash
+npx mysql-db-mcp
+```
+
+## MCP Client Config
+
+Read-only mode:
+
+```json
+{
+  "mcpServers": {
+    "mysql-db": {
+      "command": "npx",
+      "args": ["-y", "mysql-db-mcp"],
+      "env": {
+        "MYSQL_HOST": "127.0.0.1",
+        "MYSQL_PORT": "3306",
+        "MYSQL_USER": "readonly_user",
+        "MYSQL_PASSWORD": "your_password",
+        "MYSQL_DATABASE": "your_database",
+        "MYSQL_MAX_ROWS": "200"
+      }
+    }
+  }
+}
+```
+
+Allow inserts:
+
+```json
+{
+  "mcpServers": {
+    "mysql-db": {
+      "command": "npx",
+      "args": ["-y", "mysql-db-mcp"],
+      "env": {
+        "MYSQL_HOST": "127.0.0.1",
+        "MYSQL_PORT": "3306",
+        "MYSQL_USER": "writer_user",
+        "MYSQL_PASSWORD": "your_password",
+        "MYSQL_DATABASE": "your_database",
+        "MYSQL_ENABLE_WRITE": "true",
+        "MYSQL_WRITE_ALLOWED_SCHEMAS": "your_database",
+        "MYSQL_WRITE_ALLOWED_TABLES": "users,orders",
+        "MYSQL_REQUIRE_CONFIRMATION": "true",
+        "MYSQL_MAX_INSERT_ROWS": "100"
+      }
+    }
+  }
+}
+```
+
+Allow DDL:
+
+```json
+{
+  "mcpServers": {
+    "mysql-db": {
+      "command": "npx",
+      "args": ["-y", "mysql-db-mcp"],
+      "env": {
+        "MYSQL_HOST": "127.0.0.1",
+        "MYSQL_PORT": "3306",
+        "MYSQL_USER": "ddl_user",
+        "MYSQL_PASSWORD": "your_password",
+        "MYSQL_DATABASE": "your_database",
+        "MYSQL_ENABLE_DDL": "true",
+        "MYSQL_DDL_ALLOWED_SCHEMAS": "your_database",
+        "MYSQL_DDL_ALLOWED_TABLES": "users,orders",
+        "MYSQL_REQUIRE_CONFIRMATION": "true"
+      }
+    }
+  }
+}
+```
+
+Allow inserts and DDL:
+
+```json
+{
+  "mcpServers": {
+    "mysql-db": {
+      "command": "npx",
+      "args": ["-y", "mysql-db-mcp"],
+      "env": {
+        "MYSQL_HOST": "127.0.0.1",
+        "MYSQL_PORT": "3306",
+        "MYSQL_USER": "admin_limited_user",
+        "MYSQL_PASSWORD": "your_password",
+        "MYSQL_DATABASE": "your_database",
+        "MYSQL_ENABLE_WRITE": "true",
+        "MYSQL_ENABLE_DDL": "true",
+        "MYSQL_WRITE_ALLOWED_SCHEMAS": "your_database",
+        "MYSQL_WRITE_ALLOWED_TABLES": "users,orders",
+        "MYSQL_DDL_ALLOWED_SCHEMAS": "your_database",
+        "MYSQL_DDL_ALLOWED_TABLES": "users,orders",
+        "MYSQL_REQUIRE_CONFIRMATION": "true"
+      }
+    }
+  }
+}
+```
+
+## Tool Examples
+
+SELECT:
+
+```json
+{
+  "sql": "SELECT id, email FROM users WHERE status = ? LIMIT 10",
+  "params": ["active"]
+}
+```
+
+EXPLAIN:
+
+```json
+{
+  "sql": "SELECT id, email FROM users WHERE status = ? LIMIT 10",
+  "params": ["active"]
+}
+```
+
+Insert one row:
+
+```json
+{
+  "schema": "your_database",
+  "table": "users",
+  "data": {
+    "email": "a@example.com",
+    "status": "active"
+  },
+  "confirm": true
+}
+```
+
+Insert multiple rows:
+
+```json
+{
+  "schema": "your_database",
+  "table": "users",
+  "rows": [
+    { "email": "a@example.com", "status": "active" },
+    { "email": "b@example.com", "status": "pending" }
+  ],
+  "confirm": true
+}
+```
+
+Add a column:
+
+```json
+{
+  "schema": "your_database",
+  "table": "users",
+  "columnName": "nickname",
+  "columnType": "VARCHAR(255)",
+  "nullable": true,
+  "comment": "Display name",
+  "afterColumn": "email",
+  "confirm": true
+}
+```
+
+Modify a column:
+
+```json
+{
+  "schema": "your_database",
+  "table": "users",
+  "columnName": "nickname",
+  "columnType": "VARCHAR(128)",
+  "nullable": true,
+  "comment": "Short display name",
+  "confirm": true
+}
+```
+
+Drop a column:
+
+```json
+{
+  "schema": "your_database",
+  "table": "users",
+  "columnName": "nickname",
+  "confirm": true
+}
+```
+
+Rename a column:
+
+```json
+{
+  "schema": "your_database",
+  "table": "users",
+  "oldColumnName": "nickname",
+  "newColumnName": "display_name",
+  "confirm": true
+}
+```
+
+Add an index:
+
+```json
+{
+  "schema": "your_database",
+  "table": "users",
+  "indexName": "idx_users_status",
+  "columns": ["status"],
+  "unique": false,
+  "confirm": true
+}
+```
+
+Drop an index:
+
+```json
+{
+  "schema": "your_database",
+  "table": "users",
+  "indexName": "idx_users_status",
+  "confirm": true
+}
+```
+
+## MCP Inspector
+
+Build first, then run the MCP Inspector:
+
+```bash
+npm run build
+npx @modelcontextprotocol/inspector node dist/index.js
+```
+
+Set MySQL environment variables in the Inspector process before testing tools.
+
+## MySQL Account Recommendations
+
+Do not use `root` in production.
+
+Read-only user:
+
+```sql
+CREATE USER 'mcp_readonly'@'%' IDENTIFIED BY 'your_password';
+GRANT SELECT ON your_database.* TO 'mcp_readonly'@'%';
+FLUSH PRIVILEGES;
+```
+
+Insert user:
+
+```sql
+CREATE USER 'mcp_writer'@'%' IDENTIFIED BY 'your_password';
+GRANT SELECT, INSERT ON your_database.* TO 'mcp_writer'@'%';
+FLUSH PRIVILEGES;
+```
+
+DDL user:
+
+```sql
+CREATE USER 'mcp_ddl'@'%' IDENTIFIED BY 'your_password';
+GRANT SELECT, ALTER, INDEX ON your_database.* TO 'mcp_ddl'@'%';
+FLUSH PRIVILEGES;
+```
+
+Development user:
+
+```sql
+CREATE USER 'mcp_dev'@'%' IDENTIFIED BY 'your_password';
+GRANT SELECT, INSERT, ALTER, INDEX ON your_database.* TO 'mcp_dev'@'%';
+FLUSH PRIVILEGES;
+```
+
+The MCP Server does not execute authorization SQL. A DBA or developer should run those SQL statements manually.
+
+## Safety Notes
+
+- Keep the default read-only mode for production unless there is a clear operational need.
+- Prefer separate database accounts for read-only, insert, and DDL use cases.
+- Use `MYSQL_WRITE_ALLOWED_SCHEMAS` and `MYSQL_WRITE_ALLOWED_TABLES` to narrow write scope.
+- Use `MYSQL_DDL_ALLOWED_SCHEMAS` and `MYSQL_DDL_ALLOWED_TABLES` to narrow DDL scope.
+- DDL should be enabled only in development or tightly controlled environments.
+- MySQL DDL commonly causes implicit commits and cannot be treated as safely rollbackable.
+- `confirm: true` exists to make write and DDL calls explicit at the tool boundary.
+- Passwords and full connection strings are never written to logs by this server.
+
+## Publish To npm
+
+```bash
+npm login
+npm run build
+npm publish --access public
+```

package/dist/config.d.ts

@@ -0,0 +1,26 @@
+export declare const config: {
+    readonly mysql: {
+        readonly host: string;
+        readonly port: number;
+        readonly user: string;
+        readonly password: string;
+        readonly database: string | undefined;
+        readonly ssl: boolean;
+        readonly connectionLimit: number;
+        readonly maxRows: number;
+    };
+    readonly security: {
+        readonly enableWrite: boolean;
+        readonly enableDDL: boolean;
+        readonly writeAllowedSchemas: string[];
+        readonly writeAllowedTables: string[];
+        readonly ddlAllowedSchemas: string[];
+        readonly ddlAllowedTables: string[];
+        readonly blockedSchemas: readonly ["mysql", "information_schema", "performance_schema", "sys"];
+        readonly blockedTables: string[];
+        readonly maxInsertRows: number;
+        readonly requireConfirmation: boolean;
+    };
+};
+export type AppConfig = typeof config;
+export declare function defaultSchema(): string;

package/dist/config.js

@@ -0,0 +1,83 @@
+import { z } from "zod";
+function parseBoolean(value, defaultValue) {
+    if (value === undefined || value === "") {
+        return defaultValue;
+    }
+    if (/^(true|1|yes|on)$/i.test(value)) {
+        return true;
+    }
+    if (/^(false|0|no|off)$/i.test(value)) {
+        return false;
+    }
+    throw new Error(`Invalid boolean value: ${value}`);
+}
+function parseInteger(value, defaultValue, min, max) {
+    if (value === undefined || value === "") {
+        return defaultValue;
+    }
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < min || parsed > max) {
+        throw new Error(`Invalid integer value: ${value}. Expected ${min}-${max}.`);
+    }
+    return parsed;
+}
+function parseCsv(value) {
+    if (!value) {
+        return [];
+    }
+    return value
+        .split(",")
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+}
+const envSchema = z.object({
+    MYSQL_HOST: z.string().default("127.0.0.1"),
+    MYSQL_PORT: z.string().optional(),
+    MYSQL_USER: z.string().default("root"),
+    MYSQL_PASSWORD: z.string().optional(),
+    MYSQL_DATABASE: z.string().optional(),
+    MYSQL_SSL: z.string().optional(),
+    MYSQL_CONNECTION_LIMIT: z.string().optional(),
+    MYSQL_MAX_ROWS: z.string().optional(),
+    MYSQL_ENABLE_WRITE: z.string().optional(),
+    MYSQL_ENABLE_DDL: z.string().optional(),
+    MYSQL_WRITE_ALLOWED_SCHEMAS: z.string().optional(),
+    MYSQL_WRITE_ALLOWED_TABLES: z.string().optional(),
+    MYSQL_DDL_ALLOWED_SCHEMAS: z.string().optional(),
+    MYSQL_DDL_ALLOWED_TABLES: z.string().optional(),
+    MYSQL_BLOCKED_TABLES: z.string().optional(),
+    MYSQL_MAX_INSERT_ROWS: z.string().optional(),
+    MYSQL_REQUIRE_CONFIRMATION: z.string().optional()
+});
+const env = envSchema.parse(process.env);
+export const config = {
+    mysql: {
+        host: env.MYSQL_HOST,
+        port: parseInteger(env.MYSQL_PORT, 3306, 1, 65535),
+        user: env.MYSQL_USER,
+        password: env.MYSQL_PASSWORD ?? "",
+        database: env.MYSQL_DATABASE,
+        ssl: parseBoolean(env.MYSQL_SSL, false),
+        connectionLimit: parseInteger(env.MYSQL_CONNECTION_LIMIT, 10, 1, 100),
+        maxRows: parseInteger(env.MYSQL_MAX_ROWS, 200, 1, 10000)
+    },
+    security: {
+        enableWrite: parseBoolean(env.MYSQL_ENABLE_WRITE, false),
+        enableDDL: parseBoolean(env.MYSQL_ENABLE_DDL, false),
+        writeAllowedSchemas: parseCsv(env.MYSQL_WRITE_ALLOWED_SCHEMAS),
+        writeAllowedTables: parseCsv(env.MYSQL_WRITE_ALLOWED_TABLES),
+        ddlAllowedSchemas: parseCsv(env.MYSQL_DDL_ALLOWED_SCHEMAS),
+        ddlAllowedTables: parseCsv(env.MYSQL_DDL_ALLOWED_TABLES),
+        blockedSchemas: ["mysql", "information_schema", "performance_schema", "sys"],
+        blockedTables: parseCsv(env.MYSQL_BLOCKED_TABLES),
+        maxInsertRows: parseInteger(env.MYSQL_MAX_INSERT_ROWS, 100, 1, 10000),
+        requireConfirmation: parseBoolean(env.MYSQL_REQUIRE_CONFIRMATION, true)
+    }
+};
+export function defaultSchema() {
+    if (!config.mysql.database) {
+        throw new Error("schema is required when MYSQL_DATABASE is not configured.");
+    }
+    return config.mysql.database;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/db/MySqlClient.d.ts

@@ -0,0 +1,16 @@
+import type { ResultSetHeader } from "mysql2";
+export type QueryValue = string | number | boolean | null | Date;
+export type QueryParams = QueryValue[];
+export type DbRow = Record<string, unknown>;
+export declare class MySqlClient {
+    queryRows(sql: string, params?: QueryParams): Promise<DbRow[]>;
+    execute(sql: string, params?: QueryParams): Promise<ResultSetHeader>;
+    listSchemas(): Promise<DbRow[]>;
+    listTables(schema: string): Promise<DbRow[]>;
+    describeTable(schema: string, table: string): Promise<DbRow[]>;
+    columnExists(schema: string, table: string, column: string): Promise<boolean>;
+    columnsExist(schema: string, table: string, columns: readonly string[]): Promise<boolean>;
+    isPrimaryKeyColumn(schema: string, table: string, column: string): Promise<boolean>;
+    isUniqueIndexColumn(schema: string, table: string, column: string): Promise<boolean>;
+    indexExists(schema: string, table: string, indexName: string): Promise<boolean>;
+}

package/dist/db/MySqlClient.js

@@ -0,0 +1,115 @@
+import { config } from "../config.js";
+import { getPool } from "./MySqlPool.js";
+function convertRows(rows) {
+    if (Array.isArray(rows) && rows.every((row) => !Array.isArray(row))) {
+        return rows;
+    }
+    return [];
+}
+export class MySqlClient {
+    async queryRows(sql, params = []) {
+        const [rows] = await getPool().execute(sql, params);
+        return convertRows(rows).slice(0, config.mysql.maxRows);
+    }
+    async execute(sql, params = []) {
+        const [result] = await getPool().execute(sql, params);
+        return result;
+    }
+    async listSchemas() {
+        return this.queryRows(`
+      SELECT SCHEMA_NAME AS schemaName
+      FROM INFORMATION_SCHEMA.SCHEMATA
+      WHERE SCHEMA_NAME NOT IN ('mysql', 'information_schema', 'performance_schema', 'sys')
+      ORDER BY SCHEMA_NAME
+      `);
+    }
+    async listTables(schema) {
+        return this.queryRows(`
+      SELECT TABLE_SCHEMA AS schemaName,
+             TABLE_NAME AS tableName,
+             TABLE_TYPE AS tableType,
+             ENGINE AS engine,
+             TABLE_ROWS AS estimatedRows,
+             CREATE_TIME AS createdAt,
+             UPDATE_TIME AS updatedAt,
+             TABLE_COMMENT AS tableComment
+      FROM INFORMATION_SCHEMA.TABLES
+      WHERE TABLE_SCHEMA = ?
+      ORDER BY TABLE_NAME
+      `, [schema]);
+    }
+    async describeTable(schema, table) {
+        return this.queryRows(`
+      SELECT COLUMN_NAME AS columnName,
+             ORDINAL_POSITION AS ordinalPosition,
+             COLUMN_DEFAULT AS columnDefault,
+             IS_NULLABLE AS isNullable,
+             DATA_TYPE AS dataType,
+             COLUMN_TYPE AS columnType,
+             CHARACTER_MAXIMUM_LENGTH AS characterMaximumLength,
+             NUMERIC_PRECISION AS numericPrecision,
+             NUMERIC_SCALE AS numericScale,
+             COLUMN_KEY AS columnKey,
+             EXTRA AS extra,
+             COLUMN_COMMENT AS columnComment
+      FROM INFORMATION_SCHEMA.COLUMNS
+      WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ?
+      ORDER BY ORDINAL_POSITION
+      `, [schema, table]);
+    }
+    async columnExists(schema, table, column) {
+        const rows = await this.queryRows(`
+      SELECT 1 AS ok
+      FROM INFORMATION_SCHEMA.COLUMNS
+      WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ? AND COLUMN_NAME = ?
+      LIMIT 1
+      `, [schema, table, column]);
+        return rows.length > 0;
+    }
+    async columnsExist(schema, table, columns) {
+        if (columns.length === 0) {
+            return false;
+        }
+        const placeholders = columns.map(() => "?").join(", ");
+        const rows = await this.queryRows(`
+      SELECT COLUMN_NAME AS columnName
+      FROM INFORMATION_SCHEMA.COLUMNS
+      WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ? AND COLUMN_NAME IN (${placeholders})
+      `, [schema, table, ...columns]);
+        return new Set(rows.map((row) => String(row.columnName))).size === new Set(columns).size;
+    }
+    async isPrimaryKeyColumn(schema, table, column) {
+        const rows = await this.queryRows(`
+      SELECT 1 AS ok
+      FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE
+      WHERE TABLE_SCHEMA = ?
+        AND TABLE_NAME = ?
+        AND COLUMN_NAME = ?
+        AND CONSTRAINT_NAME = 'PRIMARY'
+      LIMIT 1
+      `, [schema, table, column]);
+        return rows.length > 0;
+    }
+    async isUniqueIndexColumn(schema, table, column) {
+        const rows = await this.queryRows(`
+      SELECT 1 AS ok
+      FROM INFORMATION_SCHEMA.STATISTICS
+      WHERE TABLE_SCHEMA = ?
+        AND TABLE_NAME = ?
+        AND COLUMN_NAME = ?
+        AND NON_UNIQUE = 0
+      LIMIT 1
+      `, [schema, table, column]);
+        return rows.length > 0;
+    }
+    async indexExists(schema, table, indexName) {
+        const rows = await this.queryRows(`
+      SELECT 1 AS ok
+      FROM INFORMATION_SCHEMA.STATISTICS
+      WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ? AND INDEX_NAME = ?
+      LIMIT 1
+      `, [schema, table, indexName]);
+        return rows.length > 0;
+    }
+}
+//# sourceMappingURL=MySqlClient.js.map

package/dist/db/MySqlClient.js.map

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

package/dist/db/MySqlPool.d.ts

@@ -0,0 +1,3 @@
+import { type Pool } from "mysql2/promise";
+export declare function getPool(): Pool;
+export declare function closePool(): Promise<void>;

package/dist/db/MySqlPool.js

@@ -0,0 +1,36 @@
+import mysql from "mysql2/promise";
+import { config } from "../config.js";
+import { logger } from "../logger.js";
+let pool;
+export function getPool() {
+    if (!pool) {
+        pool = mysql.createPool({
+            host: config.mysql.host,
+            port: config.mysql.port,
+            user: config.mysql.user,
+            password: config.mysql.password,
+            database: config.mysql.database,
+            waitForConnections: true,
+            connectionLimit: config.mysql.connectionLimit,
+            multipleStatements: false,
+            ssl: config.mysql.ssl ? {} : undefined,
+            namedPlaceholders: false
+        });
+        logger.info("MySQL pool created", {
+            host: config.mysql.host,
+            port: config.mysql.port,
+            user: config.mysql.user,
+            database: config.mysql.database,
+            connectionLimit: config.mysql.connectionLimit
+        });
+    }
+    return pool;
+}
+export async function closePool() {
+    if (pool) {
+        await pool.end();
+        pool = undefined;
+        logger.info("MySQL pool closed");
+    }
+}
+//# sourceMappingURL=MySqlPool.js.map

package/dist/db/MySqlPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MySqlPool.js","sourceRoot":"","sources":["../../src/db/MySqlPool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,IAAI,IAAsB,CAAC;AAE3B,MAAM,UAAU,OAAO;IACrB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC;YACtB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;YACvB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;YACvB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;YACvB,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ;YAC/B,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ;YAC/B,kBAAkB,EAAE,IAAI;YACxB,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,eAAe;YAC7C,kBAAkB,EAAE,KAAK;YACzB,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;YACtC,iBAAiB,EAAE,KAAK;SACzB,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;YAChC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;YACvB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;YACvB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;YACvB,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ;YAC/B,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,eAAe;SAC9C,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;QACjB,IAAI,GAAG,SAAS,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

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