mysql_mcp

MySQL MCP サーバー

MySQL データベースへの読み取り専用アクセスを提供する Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、MCP クライアント（Claude Desktop やその他の AI アシスタントなど）から、データベーススキーマの探索、テーブル構造の確認、安全な SELECT クエリの実行ができます。

機能

ツール

• describe_table - 列、型、キーなどのテーブル構造を表示します
• query - 検証済みの読み取り専用 SQL クエリ（SELECT 文のみ）を実行します

リソース

• mysql://schemas - 利用可能なすべてのデータベーススキーマを一覧表示します
• mysql://schemas/{schema}/tables - 特定のスキーマ内のテーブルを一覧表示します

プロンプト

• explore-schema - データベーススキーマの構造と関係を段階的に探索します
• query-builder - SELECT クエリの作成を対話形式で支援します

前提条件

• Node.js（v18 以上を推奨）
• MySQL データベースへのアクセス

インストール

1. リポジトリをクローンし、依存関係をインストールします。

npm install

2. TypeScript ソースをビルドします。

npm run build

設定

サンプルを基に .env ファイルを作成します。

cp .env.example .env

MySQL 接続情報を .env に設定します。

MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password

使用方法

直接実行する

npm start

MCP クライアントで設定する

MCP クライアントの設定にサーバーを追加します。たとえば、Claude Desktop の設定ファイルでは次のようにします。

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": ["/path/to/mysql_mcp/dist/index.js"],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password"
      }
    }
  }
}

セキュリティ

このサーバーは、実行前にすべてのクエリを解析して検証することで、読み取り専用アクセスを徹底します。SELECT 文のみが許可されます。INSERT、UPDATE、DELETE、その他のデータを変更する文を実行しようとすると、拒否されます。

ライセンス

ISC