Skip to main content
Glama
MCP-MySQL Server

MCP-MySQL Server

by enemyrr

@enemyrr/mcp-mysql-server

鍛冶屋のバッジ

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

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

Smithery経由でインストール

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

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

手動でインストールする

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

git clone https://github.com/enemyrr/mcp-mysql-server.git
cd mcp-mysql-server
npm install
npm run build
  1. Cursor IDE 設定にサーバーを追加します。

    • コマンドパレットを開く (Cmd/Ctrl + Shift + P)

    • 「MCP: サーバーの追加」を検索

    • 以下のフィールドに入力します:

      • 名前: mysql

      • タイプ: command

      • コマンド: node /absolute/path/to/mcp-mysql-server/build/index.js

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

Related MCP server: MySQL MCP Server

データベース構成

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

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

DATABASE_URL=mysql://user:password@host:3306/database
  1. .env 内の個々のパラメータ:

DB_HOST=localhost
DB_USER=your_user
DB_PASSWORD=your_password
DB_DATABASE=your_database
  1. ツール経由の直接接続:

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にプルリクエストを送信してください。

ライセンス

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

Available Tools

7 tools
add_columnC

Add a new column to existing table

Inputs: field (required), table (required).

connect_dbC

Connect to MySQL database using URL or config

Inputs: database, host, password, url, +2 more.

create_tableC

Create a new table in the database

Inputs: fields (required), table (required), indexes.

describe_tableB

Get table structure

Inputs: table (required).

executeC

Execute an INSERT, UPDATE, or DELETE query

Inputs: sql (required), params.

list_tablesB

List all tables in the database

Inputs: no named parameters.

queryC

Execute a SELECT query

Inputs: sql (required), params.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no ambiguity. For example, 'execute' handles INSERT/UPDATE/DELETE while 'query' handles SELECT, and 'describe_table' provides structure while 'list_tables' enumerates tables. The separation between schema operations (add_column, create_table) and data operations (execute, query) is well-defined.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with clear, descriptive names. The naming convention is uniform throughout (e.g., add_column, create_table, describe_table, list_tables), making it easy to predict functionality. There are no deviations in style or formatting.

    Tool Count5/5

    With 7 tools, this server is well-scoped for MySQL database operations. Each tool serves a specific, necessary function in the database management workflow, from connection (connect_db) to schema manipulation (create_table, add_column) and data querying (query, execute). The count avoids both bloat and insufficiency.

    Completeness4/5

    The tool set covers core MySQL operations effectively, including connection, schema management, and data querying. Minor gaps exist, such as the lack of tools for updating or deleting tables, which could limit full lifecycle management. However, agents can work around this using existing tools like 'execute' for DROP TABLE queries.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI models to interact with MySQL databases through a standardized interface, supporting queries, data manipulation, table inspection, and query performance analysis with secure prepared statements.
      40 npm
      23
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI models to interact with MySQL databases through standardized operations including querying, executing commands, listing tables, and describing table structures with secure prepared statement support.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to securely connect to and manage MySQL databases with support for multiple database connections, complete CRUD operations, schema inspection, and dynamic connection management through natural language.
      19 npm
      81
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to securely interact with MySQL databases through tools for query execution, schema inspection, and transaction management. It features built-in safety controls like row limits and query validation to ensure safe and standardized database access.
      716 npm
      -