MySQLクエリサーバーとは？

MySQLクエリサーバーは、MCPフレームワークに基づいて構築されたツールで、SSEを通じたMySQLデータベース操作のリアルタイム転送プロセスを簡素化することを目的としています。強力なSQLセキュリティチェックメカニズムとトランザクション管理機能を提供します。

MySQLクエリサーバーの使い方は？

サーバーパラメータを設定して起動するだけで使用を開始できます。シンプルなAPIインターフェースを通じて、クエリの実行、メタデータの取得、データベースの管理ができます。

適用シナリオ

リアルタイムデータ更新が必要なアプリケーション、データ管理、自動化スクリプトに適しています。

主要機能

基本クエリツール任意のSQLクエリの実行をサポートし、パラメータ化クエリも含みます。

メタデータクエリツールテーブル構造、列情報、インデックス情報などの詳細なクエリを提供します。

SQLセキュリティチェック組み込みのリスクレベル制御とSQLインジェクション防止メカニズムで、操作の安全性を確保します。

自動トランザクション管理トランザクションを自動的にコミットまたはロールバックし、データの一貫性を確保します。

ページング機能クエリ結果のページング表示をサポートします。

利点と制限

利点

強力なSQLセキュリティチェックメカニズム

リアルタイムデータ転送のサポート

自動トランザクション管理

包括的なログ記録システム

制限

環境変数の設定が必要です。

高リスク操作には追加の権限が必要な場合があります。

使い方

依存関係のインストール

プロジェクトをクローンし、必要な依存パッケージをインストールします。

環境変数の設定

必要に応じて.envファイルの設定を変更します。

サーバーの起動

メインサーバーファイルを実行してサービスを起動します。

使用例

すべてのユーザーをクエリするデータベース内のすべてのユーザー情報を取得します。

データをページング表示するテーブル内の最初の10件のレコードを表示します。

よくある質問

DELETE操作が失敗するのはなぜですか？

機密情報を表示するにはどうすればいいですか？

SQLセキュリティチェックを無効にするにはどうすればいいですか？

🚀 MySQLクエリサーバー

MySQLクエリサーバーは、PythonとMySQLデータベースに基づいて構築されたアプリケーションです。このアプリケーションは、基礎クエリ、メタデータ検索、データベース情報取得、表構造の高度な操作など、様々なMySQLクエリ操作を実行するための包括的なツールとサービスを提供します。

✨ 主な機能

高性能：MySQL接続プールとクエリ実行効率を最適化し、高い並行アクセスをサポートします。
安全性：組み込みのSQLインターセプターとセキュリティチェックメカニズムにより、悪意のある攻撃や許可されていない操作を防止します。
拡張性：モジュール化設計により、新しいクエリタイプや機能プラグインを簡単に追加できます。
使いやすさ：明確なドキュメントと使いやすいインターフェースを提供し、データベース操作のプロセスを簡素化します。

📦 インストール

プロジェクトリポジトリをローカルにクローンします。
依存関係をインストールします（requirements.txtを参照）。
環境変数を設定します（.env.exampleをテンプレートとして使用）。
サーバーを起動します。

📚 ドキュメント

プロジェクト構造

.
├── src/                     # ソースコードディレクトリ
│   ├── server.py           # メインサーバーファイル
│   ├── db/                 # データベース関連コード
│   │   └── mysql_operations.py # MySQL操作実装
│   ├── security/           # SQLセキュリティ関連コード
│   │   ├── interceptor.py   # SQLインターセプター
│   │   ├── query_limiter.py # SQLセキュリティチェッカー
│   │   └── sql_analyzer.py  # SQL分析器
│   └── tools/              # ツールクラスコード
│       ├── mysql_tool.py           # 基礎クエリツール
│       ├── mysql_metadata_tool.py  # メタデータクエリツール
│       ├── mysql_info_tool.py      # データベース情報クエリツール
│       ├── mysql_schema_tool.py    # 表構造高度クエリツール
│       └── metadata_base_tool.py   # メタデータツール基底クラス
├── tests/                  # テストコードディレクトリ
├── .env.example            # 環境変数サンプルファイル
└── requirements.txt        # プロジェクト依存ファイル

構成要件

属性	详情
Pythonバージョン	3.8以上
MySQLコネクタ	サポートされているMySQLコネクタライブラリ
環境変数	データベース接続情報とセキュリティパラメータを設定

起動コマンド

python src/server.py

デフォルトの実行アドレスは http://127.0.0.1:3000/sse です。

セキュリティメカニズム

リスクレベル制御：ALLOWED_RISK_LEVELS 環境変数を使用して、許可される操作のリスクレベルを制限します。
機密情報保護：本番環境ではデフォルトで機密データを非表示にします。開発環境では ALLOW_SENSITIVE_INFO を有効にして機密情報を表示できます。