npm - @imrieul/mysql-mcp-server - Versions diffs - 1.1.1 → 2.0.0-rc.1 - Mend

@imrieul/mysql-mcp-server 1.1.1 → 2.0.0-rc.1

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.

Files changed (11) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@imrieul/mysql-mcp-server",
-  "version": "1.1.1",
+  "version": "2.0.0-rc.1",
   "description": "MySQL MCP Server - Simple Model Context Protocol server for MySQL database operations",
   "type": "module",
   "bin": {
@@ -16,6 +16,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
+    "test:integration": "npm run build && vitest run --config tests/vitest.integration.config.ts",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src/ tests/",
     "lint:fix": "eslint --fix src/ tests/",
@@ -45,14 +46,16 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.0",
-    "mysql2": "^3.11.0",
-    "zod": "^3.25.0"
+    "@modelcontextprotocol/server": "^2.0.0",
+    "mysql2": "^3.24.4",
+    "zod": "^4.2.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
+    "@modelcontextprotocol/client": "^2.0.0",
+    "@modelcontextprotocol/sdk": "^1.30.0",
     "@types/node": "^18.19.130",
-    "@vitest/coverage-v8": "^2.1.9",
+    "@vitest/coverage-v8": "^3.2.7",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "husky": "^9.1.7",
@@ -62,9 +65,9 @@
     "tsup": "^8.0.0",
     "typescript": "^5.5.0",
     "typescript-eslint": "^8.54.0",
-    "vitest": "^2.0.0"
+    "vitest": "^3.2.7"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   }
 }

package/README.es.md DELETED Viewed

@@ -1,150 +0,0 @@
-# @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"]
-    }
-  }
-}
-```
-### Codex
-Codex usa configuración TOML, no JSON con `mcpServers`. Añade esto a `~/.codex/config.toml` o a un `.codex/config.toml` con alcance de proyecto:
-```toml
-[mcp_servers.mysql]
-command = "npx"
-args = ["-y", "@imrieul/mysql-mcp-server"]
-[mcp_servers.mysql.env]
-MYSQL_HOST = "localhost"
-MYSQL_PORT = "3306"
-MYSQL_USER = "root"
-MYSQL_PASSWORD = "your-password"
-MYSQL_DATABASE = "your-database"
-```
-### opencode
-Añade esto a `opencode.json` u `opencode.jsonc`:
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "mcp": {
-    "mysql": {
-      "type": "local",
-      "command": ["npx", "-y", "@imrieul/mysql-mcp-server"],
-      "enabled": true,
-      "environment": {
-        "MYSQL_HOST": "localhost",
-        "MYSQL_PORT": "3306",
-        "MYSQL_USER": "root",
-        "MYSQL_PASSWORD": "your-password",
-        "MYSQL_DATABASE": "your-database"
-      }
-    }
-  }
-}
-```
-### 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 DELETED Viewed

@@ -1,150 +0,0 @@
-# @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"]
-    }
-  }
-}
-```
-### Codex
-Codex utilise une configuration TOML, pas le JSON `mcpServers`. Ajoutez ceci à `~/.codex/config.toml` ou à un `.codex/config.toml` limité au projet :
-```toml
-[mcp_servers.mysql]
-command = "npx"
-args = ["-y", "@imrieul/mysql-mcp-server"]
-[mcp_servers.mysql.env]
-MYSQL_HOST = "localhost"
-MYSQL_PORT = "3306"
-MYSQL_USER = "root"
-MYSQL_PASSWORD = "your-password"
-MYSQL_DATABASE = "your-database"
-```
-### opencode
-Ajoutez ceci à `opencode.json` ou `opencode.jsonc` :
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "mcp": {
-    "mysql": {
-      "type": "local",
-      "command": ["npx", "-y", "@imrieul/mysql-mcp-server"],
-      "enabled": true,
-      "environment": {
-        "MYSQL_HOST": "localhost",
-        "MYSQL_PORT": "3306",
-        "MYSQL_USER": "root",
-        "MYSQL_PASSWORD": "your-password",
-        "MYSQL_DATABASE": "your-database"
-      }
-    }
-  }
-}
-```
-### 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 DELETED Viewed

@@ -1,150 +0,0 @@
-# @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"]
-    }
-  }
-}
-```
-### Codex
-Codexは`mcpServers` JSONではなくTOML設定を使用します。`~/.codex/config.toml`またはプロジェクトスコープの`.codex/config.toml`に追加してください。
-```toml
-[mcp_servers.mysql]
-command = "npx"
-args = ["-y", "@imrieul/mysql-mcp-server"]
-[mcp_servers.mysql.env]
-MYSQL_HOST = "localhost"
-MYSQL_PORT = "3306"
-MYSQL_USER = "root"
-MYSQL_PASSWORD = "your-password"
-MYSQL_DATABASE = "your-database"
-```
-### opencode
-`opencode.json`または`opencode.jsonc`に追加してください。
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "mcp": {
-    "mysql": {
-      "type": "local",
-      "command": ["npx", "-y", "@imrieul/mysql-mcp-server"],
-      "enabled": true,
-      "environment": {
-        "MYSQL_HOST": "localhost",
-        "MYSQL_PORT": "3306",
-        "MYSQL_USER": "root",
-        "MYSQL_PASSWORD": "your-password",
-        "MYSQL_DATABASE": "your-database"
-      }
-    }
-  }
-}
-```
-### 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 DELETED Viewed

@@ -1,150 +0,0 @@
-# @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"]
-    }
-  }
-}
-```
-### Codex
-Codex는 `mcpServers` JSON이 아니라 TOML 설정을 사용합니다. `~/.codex/config.toml` 또는 프로젝트 범위의 `.codex/config.toml`에 추가하세요:
-```toml
-[mcp_servers.mysql]
-command = "npx"
-args = ["-y", "@imrieul/mysql-mcp-server"]
-[mcp_servers.mysql.env]
-MYSQL_HOST = "localhost"
-MYSQL_PORT = "3306"
-MYSQL_USER = "root"
-MYSQL_PASSWORD = "your-password"
-MYSQL_DATABASE = "your-database"
-```
-### opencode
-`opencode.json` 또는 `opencode.jsonc`에 추가하세요:
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "mcp": {
-    "mysql": {
-      "type": "local",
-      "command": ["npx", "-y", "@imrieul/mysql-mcp-server"],
-      "enabled": true,
-      "environment": {
-        "MYSQL_HOST": "localhost",
-        "MYSQL_PORT": "3306",
-        "MYSQL_USER": "root",
-        "MYSQL_PASSWORD": "your-password",
-        "MYSQL_DATABASE": "your-database"
-      }
-    }
-  }
-}
-```
-### 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