@enemyrr/mcp-mysql-server

MySQLデータベース操作を提供するモデルコンテキストプロトコルサーバー。このサーバーにより、AIモデルは標準化されたインターフェースを介してMySQLデータベースと対話できるようになります。

カーソルIDEのインストールとセットアップ

Smithery経由でインストール

Smithery経由で Claude Desktop 用の MySQL データベースサーバーを自動的にインストールするには:

npx -y @smithery/cli install @enemyrr/mcp-mysql-server --client claude

手動でインストールする

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

git clone https://github.com/enemyrr/mcp-mysql-server.git
cd mcp-mysql-server
npm install
npm run build

Cursor IDE 設定にサーバーを追加します。
- コマンドパレットを開く (Cmd/Ctrl + Shift + P)
- 「MCP: サーバーの追加」を検索
- 以下のフィールドに入力します:
  - 名前: mysql
  - タイプ: command
  - コマンド: node /absolute/path/to/mcp-mysql-server/build/index.js

注: /absolute/path/to/プロジェクトをクローンしてビルドした実際のパスに置き換えます。

データベース構成

データベース接続は次の 3 つの方法で構成できます。

.env 内のデータベース URL (推奨):

DATABASE_URL=mysql://user:password@host:3306/database

.env 内の個々のパラメータ:

DB_HOST=localhost
DB_USER=your_user
DB_PASSWORD=your_password
DB_DATABASE=your_database

ツール経由の直接接続:

use_mcp_tool({
  server_name: "mysql",
  tool_name: "connect_db",
  arguments: {
    url: "mysql://user:password@host:3306/database"
    // OR
    workspace: "/path/to/your/project" // Will use project's .env
    // OR
    host: "localhost",
    user: "your_user",
    password: "your_password",
    database: "your_database"
  }
});

利用可能なツール

1. connect_db

URL、ワークスペースパス、または直接の資格情報を使用して MySQL データベースに接続します。

2. クエリ

オプションの準備されたステートメントパラメータを使用して SELECT クエリを実行します。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "query",
  arguments: {
    sql: "SELECT * FROM users WHERE id = ?",
    params: [1]
  }
});

3. 実行する

オプションの準備されたステートメントパラメータを使用して、INSERT、UPDATE、または DELETE クエリを実行します。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "execute",
  arguments: {
    sql: "INSERT INTO users (name, email) VALUES (?, ?)",
    params: ["John Doe", "john@example.com"]
  }
});

4. list_tables

接続されたデータベース内のすべてのテーブルを一覧表示します。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "list_tables"
});

5. テーブルの説明

特定のテーブルの構造を取得します。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "describe_table",
  arguments: {
    table: "users"
  }
});

6. テーブルを作成する

指定されたフィールドとインデックスを持つ新しいテーブルを作成します。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "create_table",
  arguments: {
    table: "users",
    fields: [
      {
        name: "id",
        type: "int",
        autoIncrement: true,
        primary: true
      },
      {
        name: "email",
        type: "varchar",
        length: 255,
        nullable: false
      }
    ],
    indexes: [
      {
        name: "email_idx",
        columns: ["email"],
        unique: true
      }
    ]
  }
});

7. 列の追加

既存のテーブルに新しい列を追加します。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "add_column",
  arguments: {
    table: "users",
    field: {
      name: "phone",
      type: "varchar",
      length: 20,
      nullable: true
    }
  }
});

特徴

複数の接続方法（URL、ワークスペース、直接）
自動クリーンアップによる安全な接続処理
クエリパラメータの準備済みステートメントのサポート
スキーマ管理ツール
包括的なエラー処理と検証
TypeScriptサポート
自動ワークスペース検出

安全

SQLインジェクションを防ぐために準備されたステートメントを使用する
環境変数による安全なパスワード処理をサポート
実行前にクエリを検証します
完了すると自動的に接続が閉じられます

エラー処理

サーバーは、次の詳細なエラーメッセージを提供します。

接続失敗
無効なクエリまたはパラメータ
構成がありません
データベースエラー
スキーマ検証エラー

貢献

貢献を歓迎します！お気軽にhttps://github.com/enemyrr/mcp-mysql-serverにプルリクエストを送信してください。

ライセンス

マサチューセッツ工科大学