Simple MCP MySQL Server

シンプルな MCP MySQL サーバー

MySQL データベースと安全にやり取りできる、軽量な Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、Claude などの AI アシスタントが、制御されたインターフェースを通じてテーブルの一覧表示、データの読み取り、SQL クエリの実行を行えます。

特長

• データベース内のすべての MySQL テーブルを一覧表示します
• すべてのテーブルの詳細なスキーマ情報を取得します
• 適切なエラー処理を備えた読み取り専用 SQL クエリを実行します
• 環境変数を通じてデータベースへのアクセスを安全に管理します
• 簡単に設定してデプロイできます

インストール

# Clone the repository
git clone [email protected]:alexcc4/mcp-mysql-server.git
cd mysql-mcp-server

# Install dependencies using uv (recommended)
uv sync

設定

次の環境変数を設定します。

• export DB_HOST=localhost # データベースホスト
• export DB_PORT=3306 # データベースポート（指定しない場合のデフォルトは 3306 です）
• export DB_USER=your_username # データベースのユーザー名
• export DB_PASSWORD=your_password # データベースのパスワード
• export DB_NAME=your_database # データベース名

使用方法

手動で起動する

uv run main.py

Claude Desktop を使用する場合

次の内容を Claude Desktop の設定ファイルに追加します。

Mac の Claude Desktop 設定ファイル：~/Library/Application Support/Claude/claude_desktop_config.json（存在しない場合は作成してください）

{
    "mcpServers": {
        "sql": {
            "command": "/path/uv",
            "args": [
                "--directory",
                "code_path",
                "run",
                "main.py"
            ],
            "env": {
                "DB_HOST": "127.0.0.1",
                "DB_PORT": "3306",
                "DB_USER": "your_user",
                "DB_PASSWORD": "your_password",
                "DB_NAME": "your_database"
           }
        }
    }
}

クエリの例

設定が完了したら、Claude に次のような質問をできます。

"Show me all tables in the database"
"Top 10 rows from users table"
"Find all orders placed in the last 30 days"
"Count of users by country"
"Show me the schema of the products table"

利用可能なリソース

サーバーは次のリソースを提供します。

• mysql://schema - すべてのテーブルとカラムを含む、データベース構造の完全な情報
• mysql://tables - データベース内のすべてのテーブルの一覧

利用可能なツール

サーバーは次のツールを提供します。

• query_data - 読み取り専用 SQL クエリを実行し、結果を返します

要件

• uv（推奨）
• Python 3.12.2+
• MySQL サーバー

セキュリティに関する考慮事項

• 必要最小限の権限（読み取り専用）を持つデータベースユーザーを使用してください
• 本番環境では root の認証情報を使用しないでください
• 機密性の高いデータベースでは、クエリのホワイトリスト化を検討してください
• すべてのデータベース操作を監視し、ログに記録してください

ライセンス

MIT

参考資料

• 公式ドキュメント
• PostgresSQL のデモ