Designcomputer Mysql MCP Server

🚀 MySQL MCP サーバー

このサーバーは、Model Context Protocol (MCP) 標準に準拠しており、MySQL データベースとの安全なやり取りを実現するためのものです。AI アシスタントがテーブルを一覧表示し、データを読み取り、制御されたインターフェースを介して SQL クエリを実行できるようにし、データベースの探索と分析をより安全に行えるようにします。

✨ 主な機能

• 利用可能な MySQL テーブルをリソースとして一覧表示する
• メッセージテーブルの内容を読み取る
• エラー処理付きで SQL クエリを実行する
• 環境変数を使用してデータベースアクセスを安全に制御する
• 包括的なログ記録を行う

📦 インストール

pip install mysql-mcp-server

📚 ドキュメント

設定

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

MYSQL_HOST=localhost
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_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

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

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

# サーバーを起動する
python -m mysql_mcp_server

開発

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

# 仮想環境を作成する
python -m venv venv
source venv/bin/activate  # または Windows では `venv\Scripts\activate`

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

# テストを実行する
pytest

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

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

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

この MCP サーバーは、データベースアクセス権限が必要です。セキュリティ上の理由から：

1. 専用の MySQL ユーザーを作成 し、最小限の権限を付与する
2. root アカウントや管理アカウントの使用を避ける
3. データベースアクセスを制限 し、必要な操作のみを許可する
4. ログ記録を有効にする 監査目的で
5. 定期的にセキュリティレビューを行う データベースアクセスをチェックする

詳細な説明については、MySQL セキュリティ設定ガイド を参照してください。これには以下が含まれます。

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

⚠️ 重要提示

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

📄 ライセンス

MIT License - 詳細については、LICENSE ファイルを参照してください。

🤝 貢献方法

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 を作成する