@imrieul/mysql-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 imrieul
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.es.md

@@ -0,0 +1,109 @@
+# @imrieul/mysql-mcp-server
+
+[English](./README.md) | [한국어](./README.ko.md) | [日本語](./README.ja.md) | [中文](./README.zh.md) | [Português](./README.pt.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
+
+Un servidor [MCP](https://modelcontextprotocol.io/) simple para MySQL.
+
+## Características
+
+- **Optimizado para LLM** — formato compacto de columnas/filas, LIMIT automático, sugerencias de error con acciones sugeridas
+- **Esquema en bloque** — `describe_all_tables` devuelve todo el esquema de la base de datos en una sola llamada
+- **Modo de solo lectura** — verificación de prefijo a nivel de aplicación + `SET SESSION TRANSACTION READ ONLY` a nivel de base de datos
+- **Tiempo de espera de consultas** — tiempo de espera basado en `Promise.race()` con limpieza de conexión garantizada
+- **Soporte SSL** — una variable de entorno para habilitar conexiones cifradas
+- **Minimalista** — 3 dependencias, sin configuración requerida
+
+## Inicio Rápido
+
+Añade a tu configuración MCP (`.mcp.json` o `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server"],
+      "env": {
+        "MYSQL_HOST": "localhost",
+        "MYSQL_PORT": "3306",
+        "MYSQL_USER": "root",
+        "MYSQL_PASSWORD": "your-password",
+        "MYSQL_DATABASE": "your-database"
+      }
+    }
+  }
+}
+```
+
+O con una cadena de conexión:
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server", "mysql://root:password@localhost:3306/mydb"]
+    }
+  }
+}
+```
+
+### Modo de solo lectura con SSL
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server", "--readonly"],
+      "env": {
+        "MYSQL_HOST": "db.example.com",
+        "MYSQL_USER": "readonly_user",
+        "MYSQL_PASSWORD": "password",
+        "MYSQL_DATABASE": "production",
+        "MYSQL_SSL": "true",
+        "MYSQL_QUERY_TIMEOUT": "10000"
+      }
+    }
+  }
+}
+```
+
+## Herramientas
+
+| Tool | Descripción | Modo de solo lectura |
+|------|-------------|----------------------|
+| `query` | Ejecutar SELECT, SHOW, DESCRIBE, EXPLAIN | Permitido |
+| `execute` | Ejecutar INSERT, UPDATE, DELETE, DDL | Bloqueado |
+| `list_databases` | Listar todas las bases de datos | Permitido |
+| `list_tables` | Listar tablas en una base de datos | Permitido |
+| `describe_table` | Mostrar esquema de tabla | Permitido |
+| `describe_all_tables` | Mostrar todos los esquemas de tabla a la vez | Permitido |
+
+## Configuración
+
+### Variables de entorno
+
+| Variable | Requerida | Por defecto | Descripción |
+|----------|-----------|-------------|-------------|
+| `MYSQL_HOST` | Sí | — | Host de MySQL |
+| `MYSQL_USER` | Sí | — | Usuario de MySQL |
+| `MYSQL_PASSWORD` | Sí | — | Contraseña de MySQL |
+| `MYSQL_PORT` | No | `3306` | Puerto de MySQL |
+| `MYSQL_DATABASE` | No | — | Base de datos por defecto |
+| `MYSQL_READONLY` | No | `false` | Modo de solo lectura |
+| `MYSQL_MAX_ROWS` | No | `100` | LIMIT automático para consultas SELECT |
+| `MYSQL_QUERY_TIMEOUT` | No | `30000` | Tiempo de espera de consulta en ms (0 para deshabilitar) |
+| `MYSQL_SSL` | No | `false` | Habilitar conexión SSL |
+
+### Cadena de conexión
+
+```
+mysql://user:password@host:port/database
+```
+
+Se pasa como el primer argumento CLI. Tiene prioridad sobre las variables de entorno.
+
+## Licencia
+
+MIT

package/README.fr.md

@@ -0,0 +1,109 @@
+# @imrieul/mysql-mcp-server
+
+[English](./README.md) | [한국어](./README.ko.md) | [日本語](./README.ja.md) | [中文](./README.zh.md) | [Español](./README.es.md) | [Português](./README.pt.md) | [Русский](./README.ru.md)
+
+Un serveur [MCP](https://modelcontextprotocol.io/) MySQL simple.
+
+## Fonctionnalités
+
+- **Compatible LLM** — format colonnes/lignes compact, LIMIT automatique, suggestions d'actions suite aux erreurs
+- **Schéma en masse** — `describe_all_tables` retourne le schéma complet de la base en un seul appel
+- **Mode lecture seule** — vérification au niveau applicatif + `SET SESSION TRANSACTION READ ONLY` au niveau base de données
+- **Timeout des requêtes** — timeout basé sur `Promise.race()` avec nettoyage garanti des connexions
+- **Support SSL** — une seule variable d'environnement pour activer les connexions chiffrées
+- **Minimal** — 3 dépendances, aucune configuration requise
+
+## Démarrage rapide
+
+Ajoutez à votre configuration MCP (`.mcp.json` ou `claude_desktop_config.json`) :
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server"],
+      "env": {
+        "MYSQL_HOST": "localhost",
+        "MYSQL_PORT": "3306",
+        "MYSQL_USER": "root",
+        "MYSQL_PASSWORD": "your-password",
+        "MYSQL_DATABASE": "your-database"
+      }
+    }
+  }
+}
+```
+
+Ou avec une chaîne de connexion :
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server", "mysql://root:password@localhost:3306/mydb"]
+    }
+  }
+}
+```
+
+### Mode lecture seule avec SSL
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server", "--readonly"],
+      "env": {
+        "MYSQL_HOST": "db.example.com",
+        "MYSQL_USER": "readonly_user",
+        "MYSQL_PASSWORD": "password",
+        "MYSQL_DATABASE": "production",
+        "MYSQL_SSL": "true",
+        "MYSQL_QUERY_TIMEOUT": "10000"
+      }
+    }
+  }
+}
+```
+
+## Outils
+
+| Outil | Description | Mode lecture seule |
+|------|-------------|----------------|
+| `query` | Exécuter SELECT, SHOW, DESCRIBE, EXPLAIN | Autorisé |
+| `execute` | Exécuter INSERT, UPDATE, DELETE, DDL | Bloqué |
+| `list_databases` | Lister toutes les bases de données | Autorisé |
+| `list_tables` | Lister les tables d'une base de données | Autorisé |
+| `describe_table` | Afficher le schéma d'une table | Autorisé |
+| `describe_all_tables` | Afficher tous les schémas de tables en une fois | Autorisé |
+
+## Configuration
+
+### Variables d'environnement
+
+| Variable | Requis | Défaut | Description |
+|----------|----------|---------|-------------|
+| `MYSQL_HOST` | Oui | — | Hôte MySQL |
+| `MYSQL_USER` | Oui | — | Utilisateur MySQL |
+| `MYSQL_PASSWORD` | Oui | — | Mot de passe MySQL |
+| `MYSQL_PORT` | Non | `3306` | Port MySQL |
+| `MYSQL_DATABASE` | Non | — | Base de données par défaut |
+| `MYSQL_READONLY` | Non | `false` | Mode lecture seule |
+| `MYSQL_MAX_ROWS` | Non | `100` | LIMIT automatique pour les requêtes SELECT |
+| `MYSQL_QUERY_TIMEOUT` | Non | `30000` | Timeout des requêtes en ms (0 pour désactiver) |
+| `MYSQL_SSL` | Non | `false` | Activer la connexion SSL |
+
+### Chaîne de connexion
+
+```
+mysql://user:password@host:port/database
+```
+
+Passée comme premier argument CLI. Prioritaire sur les variables d'environnement.
+
+## Licence
+
+MIT

package/README.ja.md

@@ -0,0 +1,109 @@
+# @imrieul/mysql-mcp-server
+
+[English](./README.md) | [한국어](./README.ko.md) | [中文](./README.zh.md) | [Español](./README.es.md) | [Português](./README.pt.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
+
+シンプルなMySQL [MCP](https://modelcontextprotocol.io/)サーバーです。
+
+## 特徴
+
+- **LLM最適化** — コンパクトなカラム/行形式、自動LIMIT、次のアクション提案を含むエラーヒント
+- **一括スキーマ取得** — `describe_all_tables`で全データベーススキーマを一度に取得
+- **読み取り専用モード** — アプリケーションレベルのプレフィックスチェック + データベースレベルの`SET SESSION TRANSACTION READ ONLY`
+- **クエリタイムアウト** — `Promise.race()`ベースのタイムアウトと確実なコネクションクリーンアップ
+- **SSL対応** — 環境変数1つで暗号化接続を有効化
+- **ミニマル** — 依存関係3つ、設定不要
+
+## クイックスタート
+
+MCPの設定ファイル（`.mcp.json`または`claude_desktop_config.json`）に追加してください。
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server"],
+      "env": {
+        "MYSQL_HOST": "localhost",
+        "MYSQL_PORT": "3306",
+        "MYSQL_USER": "root",
+        "MYSQL_PASSWORD": "your-password",
+        "MYSQL_DATABASE": "your-database"
+      }
+    }
+  }
+}
+```
+
+接続文字列を使用する場合:
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server", "mysql://root:password@localhost:3306/mydb"]
+    }
+  }
+}
+```
+
+### SSLを使用した読み取り専用モード
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server", "--readonly"],
+      "env": {
+        "MYSQL_HOST": "db.example.com",
+        "MYSQL_USER": "readonly_user",
+        "MYSQL_PASSWORD": "password",
+        "MYSQL_DATABASE": "production",
+        "MYSQL_SSL": "true",
+        "MYSQL_QUERY_TIMEOUT": "10000"
+      }
+    }
+  }
+}
+```
+
+## ツール
+
+| Tool | Description | Read-only mode |
+|------|-------------|----------------|
+| `query` | SELECT, SHOW, DESCRIBE, EXPLAINの実行 | 許可 |
+| `execute` | INSERT, UPDATE, DELETE, DDLの実行 | ブロック |
+| `list_databases` | 全データベースの一覧表示 | 許可 |
+| `list_tables` | データベース内のテーブル一覧表示 | 許可 |
+| `describe_table` | テーブルスキーマの表示 | 許可 |
+| `describe_all_tables` | 全テーブルスキーマの一括表示 | 許可 |
+
+## 設定
+
+### 環境変数
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `MYSQL_HOST` | はい | — | MySQLホスト |
+| `MYSQL_USER` | はい | — | MySQLユーザー |
+| `MYSQL_PASSWORD` | はい | — | MySQLパスワード |
+| `MYSQL_PORT` | いいえ | `3306` | MySQLポート |
+| `MYSQL_DATABASE` | いいえ | — | デフォルトデータベース |
+| `MYSQL_READONLY` | いいえ | `false` | 読み取り専用モード |
+| `MYSQL_MAX_ROWS` | いいえ | `100` | SELECTクエリの自動LIMIT |
+| `MYSQL_QUERY_TIMEOUT` | いいえ | `30000` | クエリタイムアウト(ミリ秒、0で無効化) |
+| `MYSQL_SSL` | いいえ | `false` | SSL接続を有効化 |
+
+### 接続文字列
+
+```
+mysql://user:password@host:port/database
+```
+
+最初のCLI引数として渡されます。環境変数より優先されます。
+
+## ライセンス
+
+MIT

package/README.ko.md

@@ -0,0 +1,109 @@
+# @imrieul/mysql-mcp-server
+
+[English](./README.md) | [日本語](./README.ja.md) | [中文](./README.zh.md) | [Español](./README.es.md) | [Português](./README.pt.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
+
+간단한 MySQL [MCP](https://modelcontextprotocol.io/) 서버입니다.
+
+## 특징
+
+- **LLM 친화적** — 압축된 컬럼/행 형식, 자동 LIMIT, 다음 작업 제안이 포함된 오류 힌트
+- **일괄 스키마 조회** — `describe_all_tables`로 전체 DB 스키마를 한 번에 조회
+- **읽기 전용 모드** — 애플리케이션 레벨 접두사 검사 + DB 레벨 `SET SESSION TRANSACTION READ ONLY`
+- **쿼리 타임아웃** — `Promise.race()` 기반 타임아웃 및 연결 정리 보장
+- **SSL 지원** — 환경 변수 하나로 암호화된 연결 활성화
+- **미니멀** — 3개의 의존성, 설정 불필요
+
+## 빠른 시작
+
+MCP 설정 파일(`.mcp.json` 또는 `claude_desktop_config.json`)에 추가하세요:
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server"],
+      "env": {
+        "MYSQL_HOST": "localhost",
+        "MYSQL_PORT": "3306",
+        "MYSQL_USER": "root",
+        "MYSQL_PASSWORD": "your-password",
+        "MYSQL_DATABASE": "your-database"
+      }
+    }
+  }
+}
+```
+
+또는 연결 문자열 사용:
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server", "mysql://root:password@localhost:3306/mydb"]
+    }
+  }
+}
+```
+
+### SSL을 사용하는 읽기 전용 모드
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server", "--readonly"],
+      "env": {
+        "MYSQL_HOST": "db.example.com",
+        "MYSQL_USER": "readonly_user",
+        "MYSQL_PASSWORD": "password",
+        "MYSQL_DATABASE": "production",
+        "MYSQL_SSL": "true",
+        "MYSQL_QUERY_TIMEOUT": "10000"
+      }
+    }
+  }
+}
+```
+
+## 도구
+
+| Tool | 설명 | 읽기 전용 모드 |
+|------|------|---------------|
+| `query` | SELECT, SHOW, DESCRIBE, EXPLAIN 실행 | 허용 |
+| `execute` | INSERT, UPDATE, DELETE, DDL 실행 | 차단 |
+| `list_databases` | 모든 데이터베이스 목록 조회 | 허용 |
+| `list_tables` | 데이터베이스의 테이블 목록 조회 | 허용 |
+| `describe_table` | 테이블 스키마 조회 | 허용 |
+| `describe_all_tables` | 모든 테이블 스키마를 한 번에 조회 | 허용 |
+
+## 설정
+
+### 환경 변수
+
+| 변수 | 필수 | 기본값 | 설명 |
+|------|------|--------|------|
+| `MYSQL_HOST` | Yes | — | MySQL 호스트 |
+| `MYSQL_USER` | Yes | — | MySQL 사용자 |
+| `MYSQL_PASSWORD` | Yes | — | MySQL 비밀번호 |
+| `MYSQL_PORT` | No | `3306` | MySQL 포트 |
+| `MYSQL_DATABASE` | No | — | 기본 데이터베이스 |
+| `MYSQL_READONLY` | No | `false` | 읽기 전용 모드 |
+| `MYSQL_MAX_ROWS` | No | `100` | SELECT 쿼리의 자동 LIMIT |
+| `MYSQL_QUERY_TIMEOUT` | No | `30000` | 쿼리 타임아웃 (밀리초, 0으로 비활성화) |
+| `MYSQL_SSL` | No | `false` | SSL 연결 활성화 |
+
+### 연결 문자열
+
+```
+mysql://user:password@host:port/database
+```
+
+첫 번째 CLI 인수로 전달됩니다. 환경 변수보다 우선합니다.
+
+## 라이선스
+
+MIT

package/README.md

@@ -0,0 +1,109 @@
+# @imrieul/mysql-mcp-server
+
+[한국어](./README.ko.md) | [日本語](./README.ja.md) | [中文](./README.zh.md) | [Español](./README.es.md) | [Português](./README.pt.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
+
+A simple MySQL [MCP](https://modelcontextprotocol.io/) server.
+
+## Features
+
+- **LLM-friendly** — compact column/row format, auto LIMIT, error hints with next-action suggestions
+- **Bulk schema** — `describe_all_tables` returns entire DB schema in one call
+- **Read-only mode** — app-level prefix check + DB-level `SET SESSION TRANSACTION READ ONLY`
+- **Query timeout** — `Promise.race()` based timeout with guaranteed connection cleanup
+- **SSL support** — one env var to enable encrypted connections
+- **Minimal** — 3 dependencies, zero config required
+
+## Quick Start
+
+Add to your MCP config (`.mcp.json` or `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server"],
+      "env": {
+        "MYSQL_HOST": "localhost",
+        "MYSQL_PORT": "3306",
+        "MYSQL_USER": "root",
+        "MYSQL_PASSWORD": "your-password",
+        "MYSQL_DATABASE": "your-database"
+      }
+    }
+  }
+}
+```
+
+Or with a connection string:
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server", "mysql://root:password@localhost:3306/mydb"]
+    }
+  }
+}
+```
+
+### Read-only mode with SSL
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server", "--readonly"],
+      "env": {
+        "MYSQL_HOST": "db.example.com",
+        "MYSQL_USER": "readonly_user",
+        "MYSQL_PASSWORD": "password",
+        "MYSQL_DATABASE": "production",
+        "MYSQL_SSL": "true",
+        "MYSQL_QUERY_TIMEOUT": "10000"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description | Read-only mode |
+|------|-------------|----------------|
+| `query` | Execute SELECT, SHOW, DESCRIBE, EXPLAIN | Allowed |
+| `execute` | Execute INSERT, UPDATE, DELETE, DDL | Blocked |
+| `list_databases` | List all databases | Allowed |
+| `list_tables` | List tables in a database | Allowed |
+| `describe_table` | Show table schema | Allowed |
+| `describe_all_tables` | Show all table schemas at once | Allowed |
+
+## Configuration
+
+### Environment variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `MYSQL_HOST` | Yes | — | MySQL host |
+| `MYSQL_USER` | Yes | — | MySQL user |
+| `MYSQL_PASSWORD` | Yes | — | MySQL password |
+| `MYSQL_PORT` | No | `3306` | MySQL port |
+| `MYSQL_DATABASE` | No | — | Default database |
+| `MYSQL_READONLY` | No | `false` | Read-only mode |
+| `MYSQL_MAX_ROWS` | No | `100` | Auto LIMIT for SELECT queries |
+| `MYSQL_QUERY_TIMEOUT` | No | `30000` | Query timeout in ms (0 to disable) |
+| `MYSQL_SSL` | No | `false` | Enable SSL connection |
+
+### Connection string
+
+```
+mysql://user:password@host:port/database
+```
+
+Passed as the first CLI argument. Takes priority over environment variables.
+
+## License
+
+MIT

package/README.pt.md

@@ -0,0 +1,109 @@
+# @imrieul/mysql-mcp-server
+
+[English](./README.md) | [한국어](./README.ko.md) | [日本語](./README.ja.md) | [中文](./README.zh.md) | [Español](./README.es.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
+
+Um servidor [MCP](https://modelcontextprotocol.io/) simples para MySQL.
+
+## Recursos
+
+- **Otimizado para LLM** — formato compacto de colunas/linhas, LIMIT automático, dicas de erro com sugestões de próximas ações
+- **Schema em lote** — `describe_all_tables` retorna o schema completo do banco em uma única chamada
+- **Modo somente leitura** — verificação de prefixo no nível da aplicação + `SET SESSION TRANSACTION READ ONLY` no nível do banco
+- **Timeout de consulta** — timeout baseado em `Promise.race()` com limpeza garantida da conexão
+- **Suporte a SSL** — uma variável de ambiente para habilitar conexões criptografadas
+- **Minimalista** — 3 dependências, zero configuração necessária
+
+## Início Rápido
+
+Adicione à sua configuração MCP (`.mcp.json` ou `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server"],
+      "env": {
+        "MYSQL_HOST": "localhost",
+        "MYSQL_PORT": "3306",
+        "MYSQL_USER": "root",
+        "MYSQL_PASSWORD": "your-password",
+        "MYSQL_DATABASE": "your-database"
+      }
+    }
+  }
+}
+```
+
+Ou com uma string de conexão:
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server", "mysql://root:password@localhost:3306/mydb"]
+    }
+  }
+}
+```
+
+### Modo somente leitura com SSL
+
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["-y", "@imrieul/mysql-mcp-server", "--readonly"],
+      "env": {
+        "MYSQL_HOST": "db.example.com",
+        "MYSQL_USER": "readonly_user",
+        "MYSQL_PASSWORD": "password",
+        "MYSQL_DATABASE": "production",
+        "MYSQL_SSL": "true",
+        "MYSQL_QUERY_TIMEOUT": "10000"
+      }
+    }
+  }
+}
+```
+
+## Ferramentas
+
+| Ferramenta | Descrição | Modo somente leitura |
+|------|-------------|----------------|
+| `query` | Executar SELECT, SHOW, DESCRIBE, EXPLAIN | Permitido |
+| `execute` | Executar INSERT, UPDATE, DELETE, DDL | Bloqueado |
+| `list_databases` | Listar todos os bancos de dados | Permitido |
+| `list_tables` | Listar tabelas em um banco de dados | Permitido |
+| `describe_table` | Exibir schema da tabela | Permitido |
+| `describe_all_tables` | Exibir schemas de todas as tabelas de uma vez | Permitido |
+
+## Configuração
+
+### Variáveis de ambiente
+
+| Variável | Obrigatória | Padrão | Descrição |
+|----------|----------|---------|-------------|
+| `MYSQL_HOST` | Sim | — | Host do MySQL |
+| `MYSQL_USER` | Sim | — | Usuário do MySQL |
+| `MYSQL_PASSWORD` | Sim | — | Senha do MySQL |
+| `MYSQL_PORT` | Não | `3306` | Porta do MySQL |
+| `MYSQL_DATABASE` | Não | — | Banco de dados padrão |
+| `MYSQL_READONLY` | Não | `false` | Modo somente leitura |
+| `MYSQL_MAX_ROWS` | Não | `100` | LIMIT automático para consultas SELECT |
+| `MYSQL_QUERY_TIMEOUT` | Não | `30000` | Timeout de consulta em ms (0 para desabilitar) |
+| `MYSQL_SSL` | Não | `false` | Habilitar conexão SSL |
+
+### String de conexão
+
+```
+mysql://user:password@host:port/database
+```
+
+Passada como primeiro argumento CLI. Tem prioridade sobre as variáveis de ambiente.
+
+## Licença
+
+MIT