MySQL MCP Server

Integrations

  • Provides SQL query execution capabilities against a MySQL database, including SELECT, CREATE TABLE, INSERT, UPDATE, and DELETE operations, with results returned in JSON format.

  • Runs as a Node.js application, requiring Node.js v14 or higher to execute the MySQL MCP server.

MySQL MCP サーバー

これは、MySQLデータベースへのアクセスを提供するモデルコンテキストプロトコル(MCP)サーバーです。エージェントがMySQLデータベースに対してSQLクエリを実行できるようにします。

特徴

  • MySQL データベースに対して SQL クエリを実行します。
    • データの読み取り(SELECT文)
    • テーブルの作成 (CREATE TABLE ステートメント)
    • データの挿入(INSERT INTO ステートメント)
    • データの更新(UPDATE文)
    • データの削除(DELETE FROM ステートメント)
  • クエリ結果をJSON形式で返します
  • 構成可能なデータベース接続設定
  • 一意のIDによるトランザクションログ

前提条件

  • Node.js (v14以上)
  • MySQLサーバー
  • MCP SDK

インストール

  1. このリポジトリをクローンまたはダウンロードする
  2. 依存関係をインストールします:
cd mysql-mcp-server npm install
  1. サーバーを構築します。
npm run build

構成

MySQL MCP サーバーは、構成に次の環境変数を使用します。

  • MYSQL_HOST : MySQLサーバーのホスト名(デフォルト: 'localhost')
  • MYSQL_PORT : MySQLサーバーのポート(デフォルト: 3306)
  • MYSQL_USER : MySQLユーザー名(デフォルト: 'mcp101')
  • MYSQL_PASSWORD : MySQLパスワード(デフォルト: '123qwe')
  • MYSQL_DATABASE : MySQLデータベース名(デフォルト: 'mcpdb')

データベースのセットアップ

  1. MySQL データベースを作成します。
CREATE DATABASE mcpdb;
  1. データベースへのアクセス権を持つ MySQL ユーザーを作成します。
CREATE USER 'mcp101'@'localhost' IDENTIFIED BY '123qwe'; GRANT ALL PRIVILEGES ON mcpdb.* TO 'mcp101'@'localhost'; FLUSH PRIVILEGES;
  1. サンプル データを含むテスト テーブルを作成します。
USE mcpdb; CREATE TABLE test_users ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(100), email VARCHAR(100), created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); INSERT INTO test_users (name, email) VALUES ('John Doe', 'john@example.com'), ('Jane Smith', 'jane@example.com'), ('Bob Johnson', 'bob@example.com');

MCP構成

MySQL MCP サーバーを MCP 設定ファイルに追加します。

VSCode (Claude 拡張機能)

ファイル: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

MySQLの設定に応じて引数を変更します

{ "mcpServers": { "mysql-mcp-server": { "autoApprove": [], "disabled": false, "timeout": 60, "command": "node", "args": [ "/path/to/mysql-mcp-server/build/index.js" ], "env": { "MYSQL_HOST": "localhost", "MYSQL_PORT": "3306", "MYSQL_USER": "mcp101", "MYSQL_PASSWORD": "123qwe", "MYSQL_DATABASE": "mcpdb" }, "transportType": "stdio" } } }

クロードデスクトップアプリ

ファイル: ~/Library/Application Support/Claude/claude_desktop_config.json

{ "mcpServers": { "mysql-mcp-server": { "autoApprove": [], "disabled": false, "timeout": 60, "command": "node", "args": [ "/path/to/mysql-mcp-server/build/index.js" ], "env": { "MYSQL_HOST": "localhost", "MYSQL_PORT": "3306", "MYSQL_USER": "mcp101", "MYSQL_PASSWORD": "123qwe", "MYSQL_DATABASE": "mcpdb" }, "transportType": "stdio" } } }

使用法

設定が完了したら、Claudeとの会話でMySQL MCPサーバーを使用できるようになります。例:

「test_users テーブル内のすべてのユーザーを表示できますか?」

Claude はrun_sql_queryツールを使用して次を実行します。

SELECT * FROM test_users

利用可能なツール

実行SQLクエリ

MySQL データベースに対して読み取り専用の SQL クエリ (SELECT ステートメントのみ) を実行します。

パラメータ:

  • query : 実行する SQL SELECT クエリ。

例:

{ "query": "SELECT * FROM test_users" }

テーブルを作成する

MySQL データベースに新しいテーブルを作成します。

パラメータ:

  • query : 実行する SQL CREATE TABLE クエリ。

例:

{ "query": "CREATE TABLE products (id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(100), price DECIMAL(10,2))" }

挿入データ

MySQL データベースのテーブルにデータを挿入します。

パラメータ:

  • query : 実行する SQL INSERT INTO クエリ。

例:

{ "query": "INSERT INTO products (name, price) VALUES ('Laptop', 999.99), ('Smartphone', 499.99)" }

更新データ

MySQL データベース内のテーブル内のデータを更新します。

パラメータ:

  • query : 実行する SQL UPDATE クエリ。

例:

{ "query": "UPDATE products SET price = 899.99 WHERE name = 'Laptop'" }

データを削除

MySQL データベース内のテーブルからデータを削除します。

パラメータ:

  • query : 実行する SQL DELETE FROM クエリ。

例:

{ "query": "DELETE FROM products WHERE name = 'Smartphone'" }

セキュリティに関する考慮事項

  • MCP サーバーに適切な権限を持つ専用の MySQL ユーザーを使用します。
  • データのクエリのみが必要な場合は、読み取り専用権限の使用を検討してください。
  • データベースの資格情報などの機密情報を安全に保存する
  • すべての操作は監査のために一意のトランザクションIDで記録されます

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

AI エージェントが MySQL データベースに対して SQL クエリを実行し、データの読み取り、テーブルの作成、レコードの挿入、更新、削除などの操作をサポートできるようにするモデル コンテキスト プロトコル サーバー。

  1. Features
    1. Prerequisites
      1. Installation
        1. Configuration
          1. Database Setup
            1. MCP Configuration
              1. VSCode (Claude Extension)
              2. Claude Desktop App
            2. Usage
              1. Available Tools
                1. run_sql_query
                2. create_table
                3. insert_data
                4. update_data
                5. delete_data
              2. Security Considerations
                ID: chaok7d5bx