MCP MySQL Server

MCP MySQL Server

SSH トンネルを使用して MySQL に接続する MCP サーバーです。

前提条件

• Node.js（バージョン 14 以降）
• リモートサーバーへの SSH アクセス
• MySQL クライアント
• Cursor IDE

インストール

1. このリポジトリをクローンします。

git clone [URL_DEL_REPOSITORIO]
cd [NOMBRE_DEL_DIRECTORIO]

2. 設定ファイルを作成します。

cp mcp-config.env.example mcp-config.env

3. mcp-config.env の変数を設定します。

MySQL 設定変数

# Configuración de conexión MySQL
MYSQL_HOST=127.0.0.1     # Host de MySQL (por defecto localhost)
MYSQL_PORT=3306          # Puerto de MySQL (por defecto 3306)
MYSQL_USER=              # Tu usuario de MySQL
MYSQL_PASS=              # Tu contraseña de MySQL
MYSQL_DB=                # Nombre de la base de datos

# Permisos de operaciones
ALLOW_INSERT_OPERATION=false    # Permitir operaciones INSERT
ALLOW_UPDATE_OPERATION=false    # Permitir operaciones UPDATE
ALLOW_DELETE_OPERATION=false    # Permitir operaciones DELETE
ALLOW_SELECT_OPERATION=true     # Permitir operaciones SELECT (consultas)

# Configuración SSH para túnel
SSH_HOST=                # Hostname del servidor SSH
SSH_USER=                # Usuario SSH
SSH_PORT_MAPPING=3306:127.0.0.1:3306  # Mapeo de puertos para el túnel SSH

4. 依存関係をインストールします。

npm install

Cursor IDE での設定

1. C:\Users\[TU_USUARIO]\.cursor\mcp.json にある mcp.json ファイルを探すか、作成します。
2. 次の設定を追加します（リポジトリをクローンした場所に合わせてパスを調整してください）。

{
  "mcpServers": {
    "MySQL": {
      "transportType": "stdio",
      "command": "npm",
      "args": ["--silent", "--prefix", "RUTA_A_TU_PROYECTO", "run", "start-mcp"]
    }
  }
}

たとえば、プロジェクトを C:\proyectos\mcp-mysql にクローンした場合、設定は次のようになります。

{
  "mcpServers": {
    "MySQL": {
      "transportType": "stdio",
      "command": "npm",
      "args": ["--silent", "--prefix", "C:\\proyectos\\mcp-mysql", "run", "start-mcp"]
    }
  }
}

使用方法

サーバーを起動するには：

npm run start-mcp

プロジェクト構成

• start-mcp.js：SSH トンネルと MCP サーバーを起動するメインスクリプト
• mcp-config.env：設定ファイル（リポジトリには含まれていません）
• package.json：依存関係とスクリプトの定義

重要な注意事項

• 互換性を維持するため、package.json の依存関係のバージョンは変更しないでください。
• SSH アクセスが正しく設定されていることを確認してください。
• mcp-config.env ファイルを共有しないでください。
• デフォルトでは、SELECT 操作のみが有効です。必要に応じて権限を変更してください。
• リモートデータベースへの接続には SSH トンネルが必要です。ローカルデータベースを使用している場合は、SSH 設定を空のままにできます。