MySQL MCP Server v2

MySQL MCP Server v2

この MCP（Message Control Protocol）サーバーは、MySQL データベースを通じて部門予算の情報を管理および照会するためのインターフェースを提供します。

特徴

• MySQL データベースへの安全な接続
• 部門予算の管理
• 部門コードによる照会
• 部門名による検索
• 予算申請の記録
• 堅牢なエラー処理と接続管理

要件

• Python 3.6 以降
• MySQL Server（XAMPP など）
• 必要な Python パッケージ：
  • mcp
  • mysql-connector-python

インストール

1. リポジトリをクローンします
2. 依存関係をインストールします：

pip install mcp mysql-connector-python

設定

サーバーは、次のデフォルト設定で MySQL データベースに接続するよう構成されています：

db_config = {
    'host': 'localhost',
    'port': 3306,
    'user': 'reporte',
    'password': 'reporte',
    'database': '_REPORTE',
    'raise_on_warnings': True
}

データベースの設定に合わせて、これらのパラメーターを調整してください。

機能

1. 全状態の照会

get_estado_completo(codigo: int)

部門コードを指定して、以下を含む部門の全情報を返します：

• コード
• 名前
• 初期予算
• 申請額
• 利用可能残高
• 支払額

2. 申請の記録

registrar_solicitud(codigo: int, monto: float)

部門の新しい予算申請を記録します：

• 申請額を更新します
• 利用可能残高を再計算します
• トランザクションを安全に処理します

3. 名前による検索

buscar_por_nombre(nombre: str)

部門名で検索します：

• 部分一致検索（LIKE を使用）
• 複数の結果を返します
• 見つかった各部門の全情報を含みます

テスト

プロジェクトには、機能を確認するためのテストスクリプトが含まれています：

• test_buscar_nombre.py：名前による検索機能をテストします
• 次のコマンドでテストを実行します：

python test_buscar_nombre.py

エラー処理

サーバーは、堅牢なエラー処理を実装しています：

• データベース接続エラー
• クエリエラー
• データの検証
• トランザクションエラー発生時の自動ロールバック

データベース構造

メインテーブル departamentos には、次のフィールドが含まれています：

• codigo (int)：部門の一意の識別子
• nombre (varchar)：部門名
• inicial (decimal)：初期予算
• solicitado (decimal)：申請額
• saldo (decimal)：利用可能残高
• pagado (decimal)：支払額

実行

サーバーを起動するには：

python mysql_mcp_server_v2.py

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

• データベースの認証情報はコードにハードコードされています。本番環境では、環境変数または安全な設定ファイルを使用することをお勧めします。
• コンテキストマネージャーパターンを使用して、安全な接続管理を実装しています。
• トランザクションは適切なコミット／ロールバックで処理されます。

コントリビューション

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

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については LICENSE ファイルを参照してください。