Mysql

🚀 MySQL MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を実装しており、MySQLデータベースと安全にやり取りすることができます。AIアシスタントがテーブルを一覧表示し、データを読み取り、制御されたインターフェイスを通じてSQLクエリを実行できるようにし、データベースの探索と分析をより安全かつ構造化されたものにします。

✨ 主な機能

• 利用可能なMySQLテーブルをリソースとして一覧表示
• テーブル内容を読み取り
• SQLクエリを実行し、適切なエラー処理を行う
• 環境変数を使用してデータベースアクセスの安全性を実現
• 全面的なログ記録

📦 インストール

以下の環境変数を設定してください。

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": "python",
      "args": [
        "-m", 
        "src.mysql_mcp_server.server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

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

# リポジトリをクローン
git clone https://github.com/designcomputer/mysql_mcp_server.git
cd mysql_mcp_server

# 依存関係をインストール
pip install -r requirements.txt

# サーバーを起動
python -m src.mysql_mcp_server.server

開発環境での実行

# リポジトリをクローン
git clone https://github.com/designcomputer/mysql_mcp_server.git
cd mysql_mcp_server

# 仮想環境を作成
python -m venv py-mcp-mysql_venv
source py-mcp-mysql_venv/bin/activate  # または Windowsの場合は `py-mcp-mysql_venv\Scripts\activate`

# 開発用の依存関係をインストール
pip install -r requirements-dev.txt

# テストを実行
pytest

📚 ドキュメント

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

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

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

このMCPサーバーは、データベースへのアクセス権限が必要です。安全を確保するために：

1. 専用のMySQLユーザーを作成し、最小限の権限を付与します。
2. rootの認証情報や管理アカウントを使用しないでください。
3. データベースへのアクセスを制限し、必要な操作のみを実行できるようにします。
4. ログ記録を有効にして監査を行います。
5. 定期的にセキュリティレビューを行い、データベースへのアクセスを確認します。

MySQL セキュリティ設定ガイドを参照して、以下の詳細を確認できます：

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

⚠️ 重要提示

データベースアクセスを設定する際は、常に最小特権の原則に従ってください。

貢献ガイド

1. リポジトリをフォークします。
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を作成します。

📄 ライセンス

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