Michael7736 Mysql MCP Server

🚀 MySQL MCP サーバー

このサーバーは、MySQL データベースへのアクセスを提供する Model Context Protocol (MCP) サーバーです。プロキシが MySQL データベースに対する SQL クエリを実行できるようにします。

✨ 主な機能

• MySQL データベース上での SQL クエリの実行：
  • データの読み取り（SELECT 文）
  • テーブルの作成（CREATE TABLE 文）
  • データの挿入（INSERT INTO 文）
  • データの更新（UPDATE 文）
  • データの削除（DELETE FROM 文）
• クエリ結果を JSON 形式で返す
• データベース接続設定の設定可能
• 一意の識別子を持つトランザクションログ

🚀 クイックスタート

📦 インストール

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

cd mysql-mcp-server
npm install

3. サーバーをビルドします。

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;

2. データベースにアクセスする権限を持つ MySQL ユーザーを作成します。

CREATE USER 'mcp101'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON mcpdb.* TO 'mcp101'@'localhost';
FLUSH PRIVILEGES;

3. テスト用のテーブルを作成します。

USE mcpdb;
CREATE TABLE products (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(255),
    price DECIMAL(10, 2)
);

🛠️ MCP 設定

異なる環境で MySQL MCP サーバーを設定します。

• VS Code：settings.json に以下の内容を追加します。

{
    "mcp.servers": [
        {
            "name": "mysql-mcp-server",
            "type": "mysql",
            "host": "localhost",
            "port": 3306,
            "database": "mcpdb",
            "user": "mcp101"
        }
    ]
}

💻 使用例

会話で以下の構文を使用してツールを呼び出します。

{
    "tools": {
        "mysql-mcp-server": {
            "function": "executeQuery",
            "args": {
                "query": "SELECT * FROM products LIMIT 5;"
            }
        }
    }
}

利用可能なツール

クエリの実行

任意の SQL クエリを実行するために使用します。 パラメータ

• query：実行する SQL クエリ文字列。 例

{
    "query": "SELECT * FROM products LIMIT 5;"
}

テーブルの作成

新しいデータベーステーブルを作成するために使用します。 パラメータ

• query：CREATE TABLE 文。 例

{
    "query": "CREATE TABLE users (id INT PRIMARY KEY, username VARCHAR(255), email VARCHAR(255));"
}

データの挿入

テーブルに新しいレコードを挿入するために使用します。 パラメータ

• query：INSERT INTO 文。 例

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

データの更新

テーブル内のレコードを更新するために使用します。 パラメータ

• query：UPDATE 文。 例

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

データの削除

テーブルからレコードを削除するために使用します。 パラメータ

• query：DELETE FROM 文。 例

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

⚠️ セキュリティに関する注意事項

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