easy-mysql-mcp

AIアシスタントが安全で構造化されたツールインターフェースを通じてMySQLデータベースを調査・クエリできるようにする、軽量な Model Context Protocol (MCP) サーバーです。

このプロジェクトはNode.js、TypeScript、公式のMCP SDK、および mysql2/promise を使用しています。stdio経由で実行されるため、Claude DesktopなどのMCPクライアントから直接使用できます。

機能

• mysql2/promise によるMySQL接続プーリング

• データ取得用の読み取り専用クエリツール

• データ変更ステートメント用の実行ツール

• テーブル、ビュー、インデックス、トリガーのスキーマ検出ツール

• EXPLAIN を使用したクエリプランの調査

• 現在のユーザーと権限の調査

• MCP以外のログがstdioプロトコルを汚染しないようにするstdout保護

要件

• Node.js 18以降

• npm

• 到達可能なMySQL互換データベース

インストール

npx を使用してサーバーを直接実行します：

npx -y easy-mysql-mcp

リポジトリをクローンした後のローカル開発用：

cd easy-mysql-mcp
npm install
npm run build

設定

環境変数を使用してサーバーを設定します。MCPクライアントの設定を通じて提供するか、ローカルの .env ファイルを作成して設定できます。

.env の例：

MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=your_database

使用方法

npx を通じてパッケージを起動するようにMCPクライアントを設定します。

ローカル開発の場合は、まずTypeScriptソースをビルドします：

npm run build

MCPサーバーを起動します：

npm start

サーバーはstdio経由で通信するため、通常は手動で実行するのではなく、MCPクライアントによって起動されます。

Claude Desktopの例

claude_desktop_config.json にサーバーを追加します：

{
  "mcpServers": {
    "easy-mysql-mcp": {
      "command": "npx",
      "args": ["-y", "easy-mysql-mcp"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

設定を更新した後、Claude Desktopを再起動してください。

利用可能なツール

セキュリティ上の注意

• アシスタントが必要とする最小限の権限を持つ専用のMySQLユーザーを使用してください。

• 調査やレポートのみが必要な場合は、読み取り専用のデータベース認証情報を使用することを推奨します。

• mysql_execute はデータを変更する可能性があるため、注意して使用してください。

• .env ファイルや実際のデータベース認証情報をGitHubにコミットしないでください。

• 本番データに対して実行する前に、生成されたSQLを確認してください。

開発

npm run dev

これはTypeScriptをウォッチモードで実行します。

本番用ビルドを作成するには：

npm run build

プロジェクト構造

src/
  db.ts       MySQL pool and query helpers
  index.ts    MCP server and tool registration
  proxy.ts    stdout protection for stdio-based MCP transport

ライセンス

ISC