MCP Server Mysql

🚀 MySQL MCP サーバ

このサーバは、モデルコンテキストプロトコル（MCP）に基づいた MySQL データベースとの安全なインタラクションを実現します。AI アシスタントがテーブルの一覧表示、データの読み取り、SQL クエリの実行を行えるようにし、制御されたインターフェースを通じてデータベースの安全な探索と分析を可能にします。

✨ 主な機能

• MySQL テーブルの一覧を取得
• テーブルの内容を読み取り
• エラーハンドリング付きの SQL クエリを実行
• 環境変数を使用した安全なデータベースアクセス
• 包括的なログ記録

📦 インストール

pip install mysql-mcp-server

📚 ドキュメント

設定

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

MYSQL_HOST=localhost     # データベースホスト
MYSQL_PORT=3306         # オプション：データベースポート（指定しない場合は 3306 がデフォルト）
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=your_database

使用方法

Claude Desktop との連携

claude_desktop_config.json に以下の内容を追加します。

{
  "mcpServers": {
    "mysql": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/mysql_mcp_server",
        "run",
        "mysql_mcp_server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

独立したサーバとして実行

• データベースパラメータを設定
• メインアプリケーションを実行

セキュリティに関する注意事項

• 環境変数や認証情報を決してコミットしないでください。
• 権限が制限された MySQL ユーザを使用してください。
• 本番環境ではクエリのホワイトリストを実装することを検討してください。
• すべてのデータベース操作を監視し、記録してください。

セキュリティのベストプラクティス

この MCP サーバを実行するにはデータベースへのアクセス権限が必要です。セキュリティを確保するために：

1. 専用の MySQL ユーザを作成し、最小限の権限を付与します。
2. root 認証情報や管理アカウントの使用を禁止します。
3. 必要な操作のみにデータベースアクセスを制限します。
4. 監査のためにログ記録を有効化します。
5. 定期的にデータベースアクセスのセキュリティレビューを実施します。

詳細な説明については、MySQL セキュリティ設定ガイドを参照してください。

• 制限付きの MySQL ユーザを作成
• 適切な権限を設定
• データベースアクセスを監視
• セキュリティのベストプラクティス

⚠️ 重要提示

常に最小権限の原則に従ってデータベースアクセスを設定してください。

📄 ライセンス

MIT ライセンス - 詳細は LICENSE ファイルを参照してください。

🔧 貢献ガイド

1. リポジトリを Fork します。
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）。
3. 変更をコミットします（git commit -m 'Add some amazing feature'）。
4. ブランチにプッシュします（git push origin feature/amazing-feature）。
5. Pull Request を作成します。