local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Supports configuration of database connection details through environment variables in .env files
Enables AI assistants to interact with MySQL databases by executing SQL queries and checking database connectivity

MCP MySQL アプリ

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

概要

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

特徴

シンプルだが強力なMySQLツール統合
型安全なツール定義
強化されたエラー処理
リクエスト中止信号の処理のサポート
セッション認識

インストール

このリポジトリをクローンする
依存関係をインストールします:

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の設定ファイルに設定を追加する必要があります。以下の手順に従ってください。

Claude AIデスクトップアプリの設定を開く
「開発者」セクションに移動します
「ツール」設定セクションを探します
次のように 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 プラットフォームでも同じです。

外部ツールまたはMCPの設定領域を見つける
このリポジトリのdist/index.jsファイルを使用してNode.jsを実行するように設定します
環境設定にMySQL接続の詳細を含める

利用可能なツール

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

sql_check_connection - MySQL接続が機能しているかどうかを確認する
sql_query - 接続されたデータベースでSQLクエリを実行する

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

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

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

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

MySQL 接続が機能しているかどうかを確認します。
サーバー上のすべてのデータベースを表示します。
現在のデータベースからすべてのテーブルを取得します。
クエリを実行して、ユーザーテーブルからすべてのユーザーを取得します。
製品テーブルのレコードを更新します。

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

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

接続を確認しています:「MySQL 接続が機能しているかどうかを確認してください。」Claude は、 sql_check_connectionツールを使用してデータベース接続を確認します。
データベースの表示:「この MySQL サーバー上のすべてのデータベースを表示してください。」Claude はSHOW DATABASES;とともにsql_queryツールを使用します。
テーブルの探索:「現在のデータベース内のすべてのテーブルを一覧表示します。」Claude はSHOW TABLES;と共にsql_queryツールを使用します。
データのクエリ:「ユーザーテーブルの最初の 10 件のレコードを表示してください。」Claude はSELECT * FROM users LIMIT 10;でsql_queryツールを使用します。
テーブルの作成:「ID、名前、価格、説明の列を持つ「products」という名前の新しいテーブルを作成します。」Claude は、 sql_queryツールを使用して、適切な CREATE TABLE ステートメントでテーブルを作成します。
データの挿入:「名前が「スマートフォン」、価格が 499.99、説明が「最新モデル」の新製品を挿入します。」Claude は、INSERT ステートメントでsql_queryツールを使用します。
レコードを更新しています:「『スマートフォン』製品の価格を 449.99 に更新します。」Claude は UPDATE ステートメントでsql_queryツールを使用します。

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

サポートとヘルプ

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

MySQL接続の詳細が正しいことを確認してください
Node.jsが正しくインストールされていることを確認してください
AIプラットフォームのMCP構成を確認する
ログファイルでエラーメッセージを確認してください
MySQLサーバーへのネットワーク接続を確認する

ライセンス

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

SQL クエリを実行し、データベース接続をチェックすることで、AI アシスタントが MySQL データベースと対話できるようにするモデルコンテキストプロトコル (MCP) サーバー。

Appeared in Searches

Five9: Cloud Contact Center Software