MCP MySQL アプリ

AI インターフェースを介して MySQL データベースと対話するためのモデル コンテキスト プロトコル (MCP) ツール サーバー実装。

概要

このプロジェクトは、AIシステムがモデルコンテキストプロトコルを介してMySQLデータベースに接続し、クエリを実行できるようにするツールセットを提供します。これにより、AIアシスタントはSQLクエリを実行し、データベース接続を確認できるようになります。

Related MCP server: MCP MySQL Server

特徴

• シンプルだが強力なMySQLツール統合

• 型安全なツール定義

• 強化されたエラー処理

• リクエスト中止信号の処理のサポート

• セッション認識

インストール

1. このリポジトリをクローンする

2. 依存関係をインストールします:

npm install

ツールの使い方

1. 初期設定

このリポジトリをクローンします:

git clone <repository-url>
cd mcp-mysql-app

依存関係をインストールします:

npm install

ルート ディレクトリに.envファイルを作成します。

MYSQL_HOST=your_mysql_host
MYSQL_USER=your_mysql_username
MYSQL_PASSWORD=your_mysql_password
MYSQL_DATABASE=your_database_name
MYSQL_PORT=3306

プロジェクトをビルドします。

npm run build

これで、 distフォルダーをさまざまな AI プラットフォームでの構成に使用できるようになりました。

2. カーソルの設定

カーソル MCP 構成ファイルを見つけます。

• Windows: C:\Users\<username>\.cursor\mcp.json

• macOS: ~/.cursor/mcp.json

• Linux: ~/.cursor/mcp.json

ファイルを編集して、MySQL MCP サーバー構成を追加します。

{
  "mcpServers": {
    "mysql": {
      "command": "<path-to-node>",
      "args": [
        "<path-to-project>/dist/index.js"
      ],
      "env": {
        "MYSQL_HOST": "your_mysql_host",
        "MYSQL_USER": "your_mysql_username",
        "MYSQL_PASSWORD": "your_mysql_password",
        "MYSQL_DATABASE": "your_database_name",
        "MYSQL_PORT": "3306"
      }
    }
  }
}

プレースホルダーを置き換えます:

• <path-to-node> : Node.js実行ファイルへのパス

• <path-to-project> : MCP MySQL Appプロジェクトディレクトリへの絶対パス

• 実際のデータベース接続の詳細を含む MySQL 環境変数

構成例:

{
  "mcpServers": {
    "mysql": {
      "command": "C:\\nvm4w\\nodejs\\node.exe",
      "args": [
        "H:\\mcp\\my-mysql\\dist\\index.js"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "password123",
        "MYSQL_DATABASE": "todo_app",
        "MYSQL_PORT": "3306"
      }
    }
  }
}

変更を有効にするには、ファイルを保存して Cursor を再起動します。

3. クロード構成

ClaudeでMCP MySQL Toolsを使用するには、Claudeの設定ファイルに設定を追加する必要があります。以下の手順に従ってください。

1. Claude AIデスクトップアプリの設定を開く

2. 「開発者」セクションに移動します

3. 「ツール」設定セクションを探します

4. 次のように MySQL MCP の構成を追加します。

{
  "tools": {
    "mysql": {
      "command": "<path-to-node>",
      "args": [
        "<path-to-project>/dist/index.js"
      ],
      "env": {
        "MYSQL_HOST": "your_mysql_host",
        "MYSQL_USER": "your_mysql_username",
        "MYSQL_PASSWORD": "your_mysql_password",
        "MYSQL_DATABASE": "your_database_name",
        "MYSQL_PORT": "3306"
      }
    }
  }
}

プレースホルダーを置き換えます:

• <path-to-node> : Node.js実行ファイルへのパス

• <path-to-project> : MCP MySQL Appプロジェクトディレクトリへの絶対パス

• 実際のデータベース接続の詳細を含む MySQL 環境変数

構成例:

{
  "tools": {
    "mysql": {
      "command": "/usr/local/bin/node",
      "args": [
        "/Users/username/projects/mcp-mysql-app/dist/index.js"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "password123",
        "MYSQL_DATABASE": "todo_app",
        "MYSQL_PORT": "3306"
      }
    }
  }
}

4. 他のプラットフォームでの設定

基本的な原理は、MCP をサポートする他の AI プラットフォームでも同じです。

1. 外部ツールまたはMCPの設定領域を見つける

2. このリポジトリのdist/index.jsファイルを使用してNode.jsを実行するように設定します

3. 環境設定にMySQL接続の詳細を含める

利用可能なツール

設定後、AI は次の MySQL ツールにアクセスできるようになります。

• sql_check_connection - MySQL接続が機能しているかどうかを確認する

• sql_query - 接続されたデータベースでSQLクエリを実行する

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

AI環境でMySQLツールを設定したら、AIに指示を出すことで使用を開始できます。以下に例をいくつか示します。

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

Cursor では、Claude に MySQL 関連のタスクを実行するよう依頼するだけです。

• MySQL 接続が機能しているかどうかを確認します。

• サーバー上のすべてのデータベースを表示します。

• 現在のデータベースからすべてのテーブルを取得します。

• クエリを実行して、ユーザー テーブルからすべてのユーザーを取得します。

• 製品テーブルのレコードを更新します。

ワークフローの例: データのクエリと操作

これらのツールの使用方法を示すワークフローの例を次に示します。

1. 接続を確認しています:

   「MySQL 接続が機能しているかどうかを確認してください。」

   Claude は、 sql_check_connectionツールを使用してデータベース接続を確認します。

2. データベースの表示:

   「この MySQL サーバー上のすべてのデータベースを表示してください。」

   Claude はSHOW DATABASES;とともにsql_queryツールを使用します。

3. テーブルの探索:

   「現在のデータベース内のすべてのテーブルを一覧表示します。」

   Claude はSHOW TABLES;と共にsql_queryツールを使用します。

4. データのクエリ:

   「ユーザー テーブルの最初の 10 件のレコードを表示してください。」

   Claude はSELECT * FROM users LIMIT 10;でsql_queryツールを使用します。

5. テーブルの作成:

   「ID、名前、価格、説明の列を持つ「products」という名前の新しいテーブルを作成します。」

   Claude は、 sql_queryツールを使用して、適切な CREATE TABLE ステートメントでテーブルを作成します。

6. データの挿入:

   「名前が「スマートフォン」、価格が 499.99、説明が「最新モデル」の新製品を挿入します。」

   Claude は、INSERT ステートメントでsql_queryツールを使用します。

7. レコードを更新しています:

   「『スマートフォン』製品の価格を 449.99 に更新します。」

   Claude は UPDATE ステートメントでsql_queryツールを使用します。

これらの例は、ツールが適切に構成されると、AI アシスタントを介して MySQL といかに自然に対話できるかを示しています。

サポートとヘルプ

このツールの使用中に問題が発生した場合は、次の手順に従ってください。

• MySQL接続の詳細が正しいことを確認してください

• Node.jsが正しくインストールされていることを確認してください

• AIプラットフォームのMCP構成を確認する

• ログファイルでエラーメッセージを確認してください

• MySQLサーバーへのネットワーク接続を確認する

ライセンス

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