MCP Mysql App

🚀 MySQL MCP ツールサーバー

このプロジェクトは、AI インターフェイスを通じて MySQL データベースとやり取りする Model Context Protocol (MCP) ツールサーバーの実装です。AI システムが MCP を介して MySQL データベースに接続し、クエリを実行できるようにします。

🚀 クイックスタート

このサーバーは、AI システムが Model Context Protocol を使って MySQL データベースに接続し、SQL クエリを実行するためのツールを提供します。AI アシスタントはこれを利用して、データベースの接続状態を確認したり、SQL クエリを実行したりすることができます。

✨ 主な機能

• シンプルで強力な MySQL ツールの統合
• 型安全なツール定義
• 強化されたエラー処理
• リクエストの終了信号の処理をサポート
• セッション感知

📦 インストール

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

npm install

💻 使用例

基本的な使用法

カーソル設定

カーソルで使用する場合、settings.json ファイルに以下の設定を行います。

{
  "mcpMySQL": {
    "host": "localhost",
    "port": 3306,
    "user": "root",
    "password": "password"
  }
}

その他の AI プラットフォーム設定

他の AI プラットフォームで使用する場合、プラットフォームの要件に応じて設定を行います。通常は、MySQL の接続情報（ホスト、ポート、ユーザー、パスワード）を提供する必要があります。

高度な使用法

AI 環境での MySQL ツールの使用

MySQL ツールを設定したら、AI 環境で使用することができます。以下は使用例です。

カーソルでの MySQL ツールの使用

カーソルでは、Claude に MySQL 関連のタスクを実行するように指示することができます。

• 接続が正常に動作していることを確認する： "MySQL 接続が正常に動作しているか確認してください。"

• すべてのデータベースを表示する： "この MySQL サーバー上のすべてのデータベースを表示してください。"

• テーブルを表示する： "現在のデータベース内のすべてのテーブルをリストアップしてください。"

• データをクエリする： "ユーザーテーブルの最初の 10 件のレコードを表示してください。"

• テーブルを作成する： "id、名前、価格、説明の列を含む 'products' という名前の新しいテーブルを作成してください。"

• データを挿入する： "名前が 'スマートフォン'、価格が 499.99、説明が '最新モデル' の新しい製品を挿入してください。"

• レコードを更新する： "スマートフォン' 製品の価格を 449.99 に更新してください。"

📚 ドキュメント

利用可能なツール

• sql_check_connection：MySQL 接続が正常に動作しているかを確認します。
• sql_query：接続されたデータベース上で SQL クエリを実行します。

サポートとヘルプ

このツールの使用中に問題が発生した場合は、以下のことを行ってください。

• MySQL の接続詳細が正しいことを確認します。
• Node.js が正しくインストールされていることを確認します。
• AI プラットフォームでの MCP 設定を確認します。
• ログファイルに表示される可能性のあるエラーメッセージを確認します。
• MySQL サーバーへのネットワーク接続を検証します。

📄 ライセンス

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