@pilat/mcp-datalink 1.0.3 → 1.2.0

package/README.md

@@ -1,414 +1,57 @@
-<h1 align="center">MCP Datalink</h1>
+# @pilat/mcp-datalink
 
-<p align="center">
-  <strong>Secure database access for AI assistants via Model Context Protocol</strong>
-</p>
+MCP server for PostgreSQL, MySQL, and SQLite. Gives AI assistants secure database access via [Model Context Protocol](https://modelcontextprotocol.io).
 
-<p align="center">
-  <a href="https://www.npmjs.com/package/@pilat/mcp-datalink"><img src="https://img.shields.io/npm/v/@pilat/mcp-datalink.svg?style=flat-square&color=blue" alt="npm version" /></a>
-  <a href="https://www.npmjs.com/package/@pilat/mcp-datalink"><img src="https://img.shields.io/npm/dm/@pilat/mcp-datalink.svg?style=flat-square&color=green" alt="npm downloads" /></a>
-  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square" alt="License: MIT" /></a>
-  <a href="https://github.com/pilat/mcp-datalink"><img src="https://img.shields.io/github/stars/pilat/mcp-datalink?style=flat-square&color=orange" alt="GitHub stars" /></a>
-  <img src="https://img.shields.io/badge/Node.js-20+-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node.js 20+" />
-</p>
-
-<p align="center">
-  <a href="#quick-start">Quick Start</a> |
-  <a href="#supported-databases">Databases</a> |
-  <a href="#mcp-client-configuration">Clients</a> |
-  <a href="#available-tools">Tools</a> |
-  <a href="#security">Security</a> |
-  <a href="#configuration">Configuration</a>
-</p>
-
----
-
-MCP Datalink is an [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that gives AI assistants secure, read/write access to your databases. Connect your favorite AI tools to PostgreSQL, MySQL, or SQLite with enterprise-grade security controls.
-
-```
-AI Assistant  <-->  MCP Datalink  <-->  Your Databases
-```
-
-## Why MCP Datalink?
-
-- **Universal Compatibility** - Works with any MCP-compatible client: Claude Desktop, Claude Code, Cursor, Cline, and more
-- **Multi-Database Support** - Connect PostgreSQL, MySQL, and SQLite simultaneously
-- **Security-First Design** - Prepared statements, query validation, readonly modes, and DDL blocking
-- **Context-Aware Output** - Smart truncation prevents context overflow in AI conversations
-- **Zero-Install Option** - Run directly with `npx` - no global installation required
-- **Production Ready** - Battle-tested with comprehensive test coverage
-
-## Supported Databases
-
-| Database | Status | Driver |
-|----------|--------|--------|
-| <img src="https://img.shields.io/badge/PostgreSQL-4169E1?style=flat-square&logo=postgresql&logoColor=white" alt="PostgreSQL" /> | Stable | node-postgres |
-| <img src="https://img.shields.io/badge/MySQL-4479A1?style=flat-square&logo=mysql&logoColor=white" alt="MySQL" /> | Stable | mysql2 |
-| <img src="https://img.shields.io/badge/SQLite-003B57?style=flat-square&logo=sqlite&logoColor=white" alt="SQLite" /> | Stable | better-sqlite3 |
-
-## Quick Start
-
-### 1. Create a configuration file
-
-Create `databases.json` in your project directory:
-
-```json
-{
-  "databases": {
-    "mydb": {
-      "url": "postgresql://user:password@localhost:5432/myapp"
-    }
-  }
-}
 ```
-
-### 2. Add to your MCP client
-
-Add to your client's MCP configuration (see [client-specific examples](#mcp-client-configuration) below):
-
-```json
-{
-  "mcpServers": {
-    "datalink": {
-      "command": "npx",
-      "args": ["-y", "@pilat/mcp-datalink", "--config", "./databases.json"]
-    }
-  }
-}
+npx @pilat/mcp-datalink
 ```
 
-### 3. Start using it!
+Works with Claude Desktop, Claude Code, Cursor, Cline, and any MCP-compatible client.
 
-Your AI assistant now has access to 6 powerful database tools:
+## Installation
 
-- `list_databases` - View all configured connections
-- `list_tables` - Browse tables with row estimates
-- `describe_table` - Inspect schemas, indexes, and foreign keys
-- `query` - Execute SELECT queries safely
-- `execute` - Run INSERT/UPDATE/DELETE with write protection
-- `explain` - Analyze query execution plans
-
-## MCP Client Configuration
-
-MCP Datalink works with any MCP-compatible client. Here are setup instructions for popular tools:
-
-<details>
-<summary><strong>Claude Desktop</strong></summary>
-
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+Add to your MCP client config:
 
 ```json
 {
   "mcpServers": {
     "datalink": {
       "command": "npx",
-      "args": ["-y", "@pilat/mcp-datalink", "--config", "/path/to/databases.json"]
+      "args": ["-y", "@pilat/mcp-datalink"],
+      "env": {
+        "DATALINK_MYDB_URL": "postgresql://user:password@localhost:5432/myapp"
+      }
     }
   }
 }
 ```
 
-</details>
+| Variable | Description |
+|----------|-------------|
+| `DATALINK_{NAME}_URL` | Connection URL (creates database named `{name}`) |
+| `DATALINK_{NAME}_READONLY` | Set to `true` to block writes |
 
-<details>
-<summary><strong>Claude Code (CLI)</strong></summary>
+**Config locations:** Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`), Claude Code (`~/.claude/settings.json`), Cursor (Settings > MCP), Cline (`cline.mcpServers` in VS Code settings).
 
-Add to `~/.claude/settings.json`:
+## Tools
 
-```json
-{
-  "mcpServers": {
-    "datalink": {
-      "command": "npx",
-      "args": ["-y", "@pilat/mcp-datalink", "--config", "./databases.json"]
-    }
-  }
-}
-```
-
-Or use the CLI command:
-
-```bash
-claude mcp add datalink -- npx -y @pilat/mcp-datalink --config ./databases.json
-```
-
-</details>
-
-<details>
-<summary><strong>Cursor</strong></summary>
-
-Add to your Cursor MCP settings (Settings > MCP):
-
-```json
-{
-  "mcpServers": {
-    "datalink": {
-      "command": "npx",
-      "args": ["-y", "@pilat/mcp-datalink", "--config", "./databases.json"]
-    }
-  }
-}
-```
-
-</details>
-
-<details>
-<summary><strong>Cline (VS Code Extension)</strong></summary>
-
-Add to your Cline MCP configuration in VS Code settings:
-
-```json
-{
-  "cline.mcpServers": {
-    "datalink": {
-      "command": "npx",
-      "args": ["-y", "@pilat/mcp-datalink", "--config", "./databases.json"]
-    }
-  }
-}
-```
-
-</details>
-
-<details>
-<summary><strong>Custom MCP Clients</strong></summary>
-
-For any MCP-compatible client, use the standard server configuration:
-
-```json
-{
-  "command": "npx",
-  "args": ["-y", "@pilat/mcp-datalink", "--config", "/absolute/path/to/databases.json"]
-}
-```
-
-Or with global installation:
-
-```bash
-npm install -g @pilat/mcp-datalink
-```
-
-```json
-{
-  "command": "mcp-datalink",
-  "args": ["--config", "/absolute/path/to/databases.json"]
-}
-```
-
-</details>
-
-## Available Tools
-
-| Tool | Description | Example Use Case |
-|------|-------------|------------------|
-| `list_databases` | List all configured database connections | "What databases do I have access to?" |
-| `list_tables` | List tables with row estimates and types | "Show me all tables in the main database" |
-| `describe_table` | Get detailed schema information | "What columns does the users table have?" |
-| `query` | Execute SELECT queries (returns Markdown) | "Find all users created this month" |
-| `execute` | Execute INSERT/UPDATE/DELETE | "Update the user's email address" |
-| `explain` | Show query execution plans | "Why is this query slow?" |
-
-### Example Interaction
-
-```
-You: "What tables are in my database?"
-AI: Let me check...
-    [Uses list_tables tool]
-
-    Found 5 tables:
-    - users (15,234 rows)
-    - orders (48,291 rows)
-    - products (1,205 rows)
-    - categories (24 rows)
-    - order_items (142,891 rows)
-```
-
-## Configuration
-
-### Configuration File
-
-Create a `databases.json` file with your database connections:
-
-```json
-{
-  "databases": {
-    "production": {
-      "url": "postgresql://user:pass@prod.example.com:5432/app",
-      "readonly": true
-    },
-    "development": {
-      "url": "postgresql://dev:dev@localhost:5432/app_dev",
-      "readonly": false
-    },
-    "analytics": {
-      "url": "mysql://analyst:pass@analytics.example.com:3306/warehouse",
-      "readonly": true
-    },
-    "local": {
-      "url": "sqlite:///path/to/database.db"
-    }
-  },
-  "defaults": {
-    "timeout": 30000,
-    "maxRows": 100,
-    "maxCellLength": 500,
-    "maxTotalSize": 65536
-  }
-}
-```
-
-### Connection Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `url` | string | required | Database connection string |
-| `readonly` | boolean | `false` | Block INSERT/UPDATE/DELETE operations |
-| `maxRows` | number | `100` | Maximum rows returned per query |
-
-### URL Formats
-
-```bash
-# PostgreSQL
-postgresql://user:password@host:5432/database
-
-# MySQL
-mysql://user:password@host:3306/database
-
-# SQLite
-sqlite:///absolute/path/to/database.db
-sqlite://./relative/path/to/database.db
-```
-
-### Environment Variables
-
-Alternative to config file - set connections via environment variables:
-
-```bash
-DB_MCP_PRODUCTION_URL=postgresql://user:pass@prod.example.com:5432/app
-DB_MCP_DEVELOPMENT_URL=postgresql://dev:dev@localhost:5432/app_dev
-```
-
-Pattern: `DB_MCP_{NAME}_URL` creates a connection named `{name}` (lowercase).
-
-### Config Resolution Order
-
-1. CLI argument: `--config ./path/to/config.json`
-2. Environment variable: `DB_MCP_CONFIG=/path/to/config.json`
-3. Current directory: `./databases.json`
-4. Home directory: `~/.config/db-mcp/databases.json`
+| Tool | Description |
+|------|-------------|
+| `list_databases` | List configured database connections |
+| `list_tables` | List tables with row counts |
+| `describe_table` | Get schema, indexes, foreign keys |
+| `query` | Run SELECT queries |
+| `execute` | Run INSERT/UPDATE/DELETE |
+| `explain` | Show query execution plans |
 
 ## Security
 
-MCP Datalink is designed with security as a core principle:
-
-| Feature | Description |
-|---------|-------------|
-| **Prepared Statements** | All queries use parameterized queries to prevent SQL injection |
-| **Query Validation** | SQL parser validates and restricts query types |
-| **Single Statement Only** | Multi-statement queries are rejected |
-| **DDL Blocking** | CREATE, DROP, ALTER, TRUNCATE are forbidden |
-| **Readonly Mode** | Per-connection write protection |
-| **Connection Isolation** | Fresh connection per request, no connection reuse |
-| **Output Limits** | Prevents context overflow with configurable size limits |
-
-### Output Limits
-
-To prevent overwhelming AI context windows, all outputs are automatically limited:
-
-| Parameter | Default | Maximum |
-|-----------|---------|---------|
-| `maxRows` | 100 | 500 |
-| `maxCellLength` | 500 chars | 1,000 chars |
-| `maxTotalSize` | 64 KB | 256 KB |
-| `maxColumns` | 50 | 100 |
-
-When limits are exceeded, responses include `truncated: true` with pagination hints.
-
-## Installation Options
-
-### Zero-Install (Recommended)
-
-Run directly with `npx` - the package is downloaded automatically:
-
-```bash
-npx @pilat/mcp-datalink --config ./databases.json
-```
-
-### Global Installation
-
-```bash
-npm install -g @pilat/mcp-datalink
-mcp-datalink --config ./databases.json
-```
-
-### Local Installation
-
-```bash
-npm install @pilat/mcp-datalink
-npx mcp-datalink --config ./databases.json
-```
-
-## Development
-
-```bash
-# Clone the repository
-git clone https://github.com/pilat/mcp-datalink.git
-cd mcp-datalink
-
-# Install dependencies
-npm install
-
-# Build
-npm run build
-
-# Run tests
-npm run test:unit        # Unit tests (fast, no external deps)
-npm run test:integration # Integration tests (uses testcontainers)
-npm test                 # All tests
-
-# Development mode
-npm run dev              # Watch mode with auto-rebuild
-```
-
-### Testing with MCP Inspector
-
-```bash
-npx @modelcontextprotocol/inspector node dist/index.js -- --config ./databases.json
-```
-
-## Contributing
-
-Contributions are welcome! Please read our contributing guidelines:
-
-1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'feat: add amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
-
-### Commit Convention
-
-We use [Conventional Commits](https://www.conventionalcommits.org/):
-
-```
-feat(tools): add new database tool
-fix(security): enforce query validation
-docs: update README
-```
-
-## Links
-
-- [GitHub Repository](https://github.com/pilat/mcp-datalink)
-- [npm Package](https://www.npmjs.com/package/@pilat/mcp-datalink)
-- [Issue Tracker](https://github.com/pilat/mcp-datalink/issues)
-- [MCP Documentation](https://modelcontextprotocol.io)
+- Prepared statements only (no SQL injection)
+- Single statement per query (no chaining)
+- DDL blocked (no DROP, ALTER, TRUNCATE)
+- Readonly mode per connection
+- Output truncation (100 rows, 64KB max)
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) for details.
-
----
-
-<p align="center">
-  <sub>Built with care by <a href="https://github.com/pilat">@pilat</a></sub>
-</p>
+MIT

package/dist/adapters/factory.d.ts

@@ -2,10 +2,6 @@
  * Database Adapter Factory
  *
  * Creates the appropriate database adapter based on connection URL scheme.
- *
- * Phase 1: PostgreSQL - DONE
- * Phase 2: MySQL - DONE
- * Phase 3: SQLite - DONE
  */
 import type { DatabaseAdapter } from './types.js';
 import type { DatabaseConfig, DefaultsConfig } from '../types.js';

package/dist/adapters/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/adapters/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA+ElE;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,cAAc,GACvB,eAAe,CASjB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQlD"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/adapters/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAgFlE;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,cAAc,GACvB,eAAe,CASjB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOlD"}

package/dist/adapters/factory.js

@@ -2,13 +2,9 @@
  * Database Adapter Factory
  *
  * Creates the appropriate database adapter based on connection URL scheme.
- *
- * Phase 1: PostgreSQL - DONE
- * Phase 2: MySQL - DONE
- * Phase 3: SQLite - DONE
  */
-import { PostgreSqlAdapter } from './postgresql/adapter.js';
 import { MySqlAdapter } from './mysql/adapter.js';
+import { PostgreSqlAdapter } from './postgresql/adapter.js';
 import { SqliteAdapter } from './sqlite/adapter.js';
 import { DbMcpError, ErrorCode } from '../utils/errors.js';
 /**
@@ -103,9 +99,8 @@ export function isSupportedUrl(url) {
  */
 export function isImplemented(url) {
     try {
-        const scheme = detectScheme(url);
-        // All three database types are now implemented (Phase 1-3)
-        return scheme === 'postgresql' || scheme === 'mysql' || scheme === 'sqlite';
+        detectScheme(url);
+        return true;
     }
     catch {
         return false;

package/dist/adapters/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/adapters/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAO3D;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,2CAA2C;IAC3C,IAAI,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACrE,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,kBAAkB;IAClB,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,gEAAgE;IAChE,IACE,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC;QAC3B,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QACnB,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;QACvB,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EACxB,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,UAAU,CAClB,SAAS,CAAC,cAAc,EACxB,gCAAgC,GAAG,IAAI;QACrC,oEAAoE,EACtE,EAAE,GAAG,EAAE,CACR,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CACxB,MAAqB,EACrB,MAAsB;IAEtB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,YAAY;YACf,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAEvC,KAAK,OAAO;YACV,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;QAElC,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QAEnC,OAAO,CAAC,CAAC,CAAC;YACR,8BAA8B;YAC9B,MAAM,WAAW,GAAU,MAAM,CAAC;YAClC,MAAM,IAAI,UAAU,CAClB,SAAS,CAAC,cAAc,EACxB,+BAA+B,WAAW,EAAE,CAC7C,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAwB,EACxB,QAAwB;IAExB,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAkB;QAC5B,QAAQ;QACR,QAAQ;KACT,CAAC;IAEF,OAAO,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,YAAY,CAAC,GAAG,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QACjC,2DAA2D;QAC3D,OAAO,MAAM,KAAK,YAAY,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/adapters/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAO3D;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,2CAA2C;IAC3C,IAAI,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACrE,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,kBAAkB;IAClB,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,gEAAgE;IAChE,IACE,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC;QAC3B,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QACnB,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;QACvB,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EACxB,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,UAAU,CAClB,SAAS,CAAC,cAAc,EACxB,gCAAgC,GAAG,IAAI;QACrC,oEAAoE,EACtE,EAAE,GAAG,EAAE,CACR,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CACxB,MAAqB,EACrB,MAAsB;IAEtB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,YAAY;YACf,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAEvC,KAAK,OAAO;YACV,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;QAElC,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QAEnC,OAAO,CAAC,CAAC,CAAC;YACR,8BAA8B;YAC9B,MAAM,WAAW,GAAU,MAAM,CAAC;YAClC,MAAM,IAAI,UAAU,CAClB,SAAS,CAAC,cAAc,EACxB,+BAA+B,WAAW,EAAE,CAC7C,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAwB,EACxB,QAAwB;IAExB,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAkB;QAC5B,QAAQ;QACR,QAAQ;KACT,CAAC;IAEF,OAAO,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,YAAY,CAAC,GAAG,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,CAAC;QACH,YAAY,CAAC,GAAG,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/adapters/mysql/adapter.d.ts

@@ -4,16 +4,8 @@
  * Implements DatabaseAdapter interface for MySQL databases.
  * Uses mysql2/promise driver with per-request connection recycling.
  */
-import type { DatabaseAdapter, AdapterConnection, AdapterConfig } from '../types.js';
+import type { AdapterConfig, AdapterConnection, DatabaseAdapter } from '../types.js';
 import type { ParsedQuery } from '../../types.js';
-/**
- * Strip SQL comments from a query
- */
-declare function stripComments(sql: string): string;
-/**
- * String-aware statement splitting
- */
-declare function splitStatements(sql: string): string[];
 /**
  * MySQL database adapter
  *
@@ -24,38 +16,17 @@ export declare class MySqlAdapter implements DatabaseAdapter {
     private readonly connectionUrl;
     private readonly timeout;
     constructor(config: AdapterConfig);
-    /**
-     * Get the default schema name for MySQL (database name from URL)
-     */
     getDefaultSchema(): string;
-    /**
-     * Parse and validate a SQL query
-     */
     parseQuery(sql: string): ParsedQuery;
-    /**
-     * Inject a LIMIT clause into a SELECT query if it doesn't have one
-     */
     injectLimit(sql: string, limit: number): string;
-    /**
-     * Validate that a SQL query is appropriate for a specific tool
-     */
     validateQueryForTool(sql: string, tool: 'query' | 'execute'): void;
-    /**
-     * Get the EXPLAIN prefix for MySQL
-     */
     getExplainPrefix(analyze: boolean): string;
-    /**
-     * Convert PostgreSQL-style placeholders ($1, $2) to MySQL-style (?)
-     */
+    /** Convert $1, $2 placeholders to ? for MySQL */
     convertPlaceholders(sql: string): string;
     /**
      * Execute a function with a managed MySQL connection
      */
     withConnection<T>(fn: (conn: AdapterConnection) => Promise<T>): Promise<T>;
-    /**
-     * Clean up resources (no persistent resources in this adapter)
-     */
     dispose(): Promise<void>;
 }
-export { stripComments, splitStatements };
 //# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/mysql/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/mysql/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAEjB,aAAa,EAEd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,WAAW,EAOZ,MAAM,gBAAgB,CAAC;AA6CxB;;GAEG;AACH,iBAAS,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA0E1C;AAED;;GAEG;AACH,iBAAS,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAwD9C;AAgED;;;;GAIG;AACH,qBAAa,YAAa,YAAW,eAAe;IAClD,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAEjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,aAAa;IAKjC;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAa1B;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAsDpC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAQ/C;;OAEG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAyClE;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAI1C;;OAEG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIxC;;OAEG;IACG,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA0ChF;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B;AAsND,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/mysql/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EAGhB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAIV,WAAW,EAGZ,MAAM,gBAAgB,CAAC;AAqDxB;;;;GAIG;AACH,qBAAa,YAAa,YAAW,eAAe;IAClD,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAEjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,aAAa;IAKjC,gBAAgB,IAAI,MAAM;IAa1B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAiBpC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAI/C,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAKlE,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAI1C,iDAAiD;IACjD,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIxC;;OAEG;IACG,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqC1E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}