Wiki: ページの作成:「== 概要 == MySQL MCPサーバは、Model Context Protocol (MCP) を通じてAIアシスタントがMySQLデータベースと対話するための標準化されたインターフェースを提供するサーバである。
MCPとは、AIアシスタントが外部ツールやデータソースと通信するためのオープンプロトコルであり、AIとデータベースをシームレスに統合する役割を担う。

MySQL MCPサーバを…」

2026-02-22T23:40:21Z

ページの作成:「== 概要 == MySQL MCPサーバは、Model Context Protocol (MCP) を通じてAIアシスタントがMySQLデータベースと対話するための標準化されたインターフェースを提供するサーバである。 MCPとは、AIアシスタントが外部ツールやデータソースと通信するためのオープンプロトコルであり、AIとデータベースをシームレスに統合する役割を担う。 MySQL MCPサーバを…」

新規ページ

== 概要 ==
MySQL MCPサーバは、Model Context Protocol (MCP) を通じてAIアシスタントがMySQLデータベースと対話するための標準化されたインターフェースを提供するサーバである。 
MCPとは、AIアシスタントが外部ツールやデータソースと通信するためのオープンプロトコルであり、AIとデータベースをシームレスに統合する役割を担う。 
 
MySQL MCPサーバを使用することにより、AIアシスタントが自然言語による指示でSQLクエリを実行し、データベースの内容を取得・操作できるようになる。 
 
代表的なMySQL MCPサーバとして、以下の2種類が広く使用されている。 
 
* benborla/mcp-server-mysql
*: Node.js (TypeScript) ベースのMCPサーバ
*: 読み取り専用アクセスをデフォルトとし、SSHトンネルやDDL操作、マルチデータベース対応、SSL/TLS接続などの高度な機能を備える。
* designcomputer/mysql_mcp_server
*: PythonベースのMCPサーバ
*: セキュリティ優先の設計で、包括的なログ機能を持ち、シンプルな構成で利用できる。
 
両サーバともMITライセンスで公開されており、Claude Desktop、Claude Code等の主要なMCPクライアント環境で動作する。 
 
主な特徴は以下の通りである。 
* MCP標準に準拠したMySQLデータベース操作インターフェース
* SQLクエリの実行、テーブル情報の取得をAIアシスタントから直接操作可能
* Claude Desktop、Claude Code、OpenCode等の主要なMCPクライアントをサポート
* セキュリティ重視の設計 (認証情報は環境変数で管理)
* Windows、MacOS、Linuxの主要なOSで動作
 

== MCPサーバの比較 ==
2つのMySQL MCPサーバの主な違いを以下の表に示す。 
 
<center>
{| class="wikitable"
|+ MySQL MCPサーバの比較
! 項目 !! benborla/mcp-server-mysql !! designcomputer/mysql_mcp_server
|-
| 実装言語 || Node.js (TypeScript) || Python
|-
| パッケージ名 || @benborla29/mcp-server-mysql || mysql-mcp-server
|-
| 実行コマンド || npx || uvx
|-
| パスワード環境変数 || MYSQL_PASS || MYSQL_PASSWORD
|-
| データベース環境変数 || MYSQL_DB || MYSQL_DATABASE
|-
| ツール名 || mysql_query || execute_sql
|-
| SSHトンネル || 対応 || 非対応
|-
| DDL操作 || 対応 (環境変数で制御) || 非対応
|-
| マルチDB対応 || 対応 (MYSQL_DB未設定時) || 非対応
|-
| レート制限 || 対応 || 非対応
|-
| 文字セット設定 || 非対応 || 対応 (MYSQL_CHARSET)
|-
| コレーション設定 || 非対応 || 対応 (MYSQL_COLLATION)
|-
| ライセンス || MIT || MIT
|}
</center>
 

== benborla/mcp-server-mysql ==
==== 概要 ====
benborla/mcp-server-mysqlは、Node.js (TypeScript) で実装されたMySQL向けのMCPサーバである。 
読み取り専用アクセスをデフォルトとし、必要に応じて環境変数でINSERT、UPDATE、DELETE、DDL操作を許可できる。 
 
主な特徴は以下の通りである。 
 
* 読み取り専用アクセスがデフォルト (書き込み操作は環境変数で明示的に許可が必要)
* SSHトンネルによるリモートデータベースへのセキュアなアクセスに対応
* DDL操作 (CREATE TABLE等) に対応
* MYSQL_DBを未設定にすることで全データベースへのアクセスが可能 (マルチDB対応)
* スキーマ固有の権限管理に対応
* レート制限によるDDoS対策
* SSL/TLS接続に対応
 
==== 動作要件 ====
benborla/mcp-server-mysqlの動作に必要な環境を以下に示す。 
 
* Node.js v20以上 (推奨)
*: <code>node --version</code> で現在のバージョンを確認できる。
* npm v9以上または pnpm
*: npmはNode.jsに同梱されている
* MySQL 5.7以上
*: MySQL 8.0以上を推奨
 
==== インストール ====
benborla/mcp-server-mysql のインストール方法を以下に示す。 
 
* グローバルインストールする場合
*: <syntaxhighlight lang="text">
npm install -g @benborla29/mcp-server-mysql
</syntaxhighlight>
*: 
* npxを使用して直接実行する場合 (インストール不要)
*: <syntaxhighlight lang="text">
npx @benborla29/mcp-server-mysql
</syntaxhighlight>
 
通常、MCPクライアントの設定ファイルにnpxコマンドを記述することで自動的に実行されるため、別途インストールは不要である。 
 
==== 環境変数 ====
benborla/mcp-server-mysqlの動作をカスタマイズするための環境変数を以下に示す。 
 
下表に、基本接続設定の環境変数を示す。 
 
<center>
{| class="wikitable"
|+ 基本接続設定
! 環境変数 !! 説明 !! デフォルト値
|-
| <code>MYSQL_HOST</code> || データベースホスト || 127.0.0.1
|-
| <code>MYSQL_PORT</code> || ポート番号 || 3306
|-
| <code>MYSQL_USER</code> || ユーザ名 || (必須)
|-
| <code>MYSQL_PASS</code> || パスワード || (必須)
|-
| <code>MYSQL_DB</code> || ターゲットデータベース名。省略時はマルチデータベースモードで動作する。 || (省略可能)
|-
| <code>MYSQL_SOCKET_PATH</code> || Unix ソケットパス || (省略可能)
|}
</center>
 
下表に、セキュリティ設定の環境変数を示す。 
 
<center>
{| class="wikitable"
|+ セキュリティ設定
! 環境変数 !! 説明 !! デフォルト値
|-
| <code>ALLOW_INSERT_OPERATION</code> || INSERT操作の許可 || false
|-
| <code>ALLOW_UPDATE_OPERATION</code> || UPDATE操作の許可 || false
|-
| <code>ALLOW_DELETE_OPERATION</code> || DELETE操作の許可 || false
|-
| <code>ALLOW_DDL_OPERATION</code> || DDL操作 (CREATE TABLE等) の許可 || false
|-
| <code>MYSQL_RATE_LIMIT</code> || レート制限 (分あたりのクエリ数) || 100
|-
| <code>MYSQL_SSL</code> || SSL接続の有効化 || (省略可能)
|-
| <code>MYSQL_DISABLE_READ_ONLY_TRANSACTIONS</code> || 読み取り専用トランザクションの無効化 || (省略可能)
|}
</center>
 
下表に、パフォーマンス設定の環境変数を示す。 
 
<center>
{| class="wikitable"
|+ パフォーマンス設定
! 環境変数 !! 説明 !! デフォルト値
|-
| <code>MYSQL_POOL_SIZE</code> || コネクションプール数 || 10
|-
| <code>MYSQL_QUERY_TIMEOUT</code> || クエリタイムアウト (ミリ秒) || 30000
|-
| <code>MYSQL_CACHE_TTL</code> || キャッシュTTL (ミリ秒) || 60000
|-
| <code>MYSQL_QUEUE_LIMIT</code> || キューイング制限 || 100
|-
| <code>MYSQL_CONNECT_TIMEOUT</code> || 接続タイムアウト (ミリ秒) || 10000
|-
| <code>MYSQL_MAX_QUERY_COMPLEXITY</code> || クエリ複雑度制限 || 1000
|}
</center>
 
下表に、SSHトンネル設定の環境変数を示す。 
 
<center>
{| class="wikitable"
|+ SSHトンネル設定
! 環境変数 !! 説明 !! デフォルト値
|-
| <code>SSH_ENABLED</code> || SSHトンネルの有効化 (true / false) || false
|-
| <code>SSH_HOST</code> || SSHホスト名 || (必須)
|-
| <code>SSH_PORT</code> || SSHポート番号 || 22
|-
| <code>SSH_USER</code> || SSHユーザ名 || (必須)
|-
| <code>SSH_KEY_PATH</code> || 秘密鍵ファイルのパス || (必須)
|}
</center>
 
==== ツール ====
下表に、benborla/mcp-server-mysqlが提供するツールを示す。 
 
<center>
{| class="wikitable"
|+ 提供ツール一覧
! ツール名 !! 説明 !! パラメータ
|-
| mysql_query || SQLクエリを実行する唯一のツール SELECTをはじめ、環境変数で許可された操作を実行できる。 || SQLクエリ文字列
|}
</center>
 

== designcomputer/mysql_mcp_server ==
==== 概要 ====
designcomputer/mysql_mcp_serverは、Pythonで実装されたMySQL向けのMCPサーバである。 
セキュリティ優先の設計を採用しており、包括的なログ機能を持つ。 
 
主な特徴は以下の通りである。 
* テーブルリストの取得、コンテンツ読み取り、SQLクエリ実行をサポート
* 包括的なログ機能による操作の追跡
* セキュリティ最優先の設計 (最小権限の原則)
 
==== 動作要件 ====
designcomputer/mysql_mcp_serverの動作に必要な環境を以下に示す。 
 
* Python 3.11以上 (推奨: 3.12以上)
*: <code>python --version</code> で現在のバージョンを確認できる。
* uv (Pythonパッケージマネージャー)
*: uvxコマンドの実行に必要
* MySQL 5.7以上
*: MySQL 8.0以上を推奨
 
==== インストール ====
designcomputer/mysql_mcp_serverのインストール方法を以下に示す。 
 
* pipを使用してインストールする場合
*: <syntaxhighlight lang="text">
pip install mysql-mcp-server
</syntaxhighlight>
*: 
* uvxを使用して直接実行する場合
*: <syntaxhighlight lang="text">
uvx --from mysql-mcp-server mysql_mcp_server
</syntaxhighlight>
 
通常、MCPクライアントの設定ファイルにuvxコマンドを記述することで自動的に実行されるため、別途インストールは不要である。 
 
==== 環境変数 ====
下表に、designcomputer/mysql_mcp_serverの動作をカスタマイズするための環境変数を示す。 
 
<center>
{| class="wikitable"
|+ 環境変数一覧
! 環境変数 !! 説明 !! デフォルト値
|-
| <code>MYSQL_HOST</code> || データベースホスト || localhost
|-
| <code>MYSQL_PORT</code> || ポート番号 || 3306
|-
| <code>MYSQL_USER</code> || ユーザ名 || (必須)
|-
| <code>MYSQL_PASSWORD</code> || パスワード (benborla版のMYSQL_PASSとは異なる点に注意) || (必須)
|-
| <code>MYSQL_DATABASE</code> || ターゲットデータベース名 (benborla版のMYSQL_DBとは異なる点に注意) || (必須)
|-
| <code>MYSQL_CHARSET</code> || 文字セット || (省略可能)
|-
| <code>MYSQL_COLLATION</code> || コレーション設定 || (省略可能)
|}
</center>
 
==== ツール ====
下表に、designcomputer/mysql_mcp_serverが提供するツールを示す。 
 
<center>
{| class="wikitable"
|+ 提供ツール一覧
! ツール名 !! 説明 !! パラメータ
|-
| execute_sql || SQLクエリを実行する唯一のツール SQLクエリ文字列を受け取り、結果を返す。 || SQLクエリ文字列
|}
</center>
 

== 設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は以下の通りである。 
 
Claude Desktopの設定ファイルを以下に示す。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
Claude Codeの設定ファイルを以下に示す。 
* Linux
*: ~/.config/claude/settings.json
* MacOS
*: ~/Library/Application Support/claude/settings.json
* Windows
*: %APPDATA%\claude\settings.json
 
OpenCodeの設定ファイルを以下に示す。 
* Linux / MacOS / Windows (共通)
*: $HOME/.opencode.json
 
==== Claude Desktopでの設定 ====
Claude Desktopの設定ファイルに以下の内容を追記する。 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
* benborla/mcp-server-mysql を使用する場合
*: <syntaxhighlight lang="json">
{
"mcpServers": {
"mcp_server_mysql": {
"command": "npx",
"args": ["-y", "@benborla29/mcp-server-mysql"],
"env": {
"MYSQL_HOST": "127.0.0.1",
"MYSQL_PORT": "3306",
"MYSQL_USER": "root",
"MYSQL_PASS": "password",
"MYSQL_DB": "mydb"
}
}
}
}
</syntaxhighlight>
*: 
* designcomputer/mysql_mcp_server を使用する場合
*: <syntaxhighlight lang="json">
{
"mcpServers": {
"mysql": {
"command": "uvx",
"args": ["--from", "mysql-mcp-server", "mysql_mcp_server"],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "your_username",
"MYSQL_PASSWORD": "your_password",
"MYSQL_DATABASE": "your_database"
}
}
}
}
</syntaxhighlight>
 
==== Claude Codeでの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを使用してMCPサーバを追加できる。 
 
* benborla/mcp-server-mysql をCLIコマンドで追加する場合
*: <syntaxhighlight lang="text">
claude mcp add mcp_server_mysql \
-e MYSQL_HOST="127.0.0.1" \
-e MYSQL_PORT="3306" \
-e MYSQL_USER="root" \
-e MYSQL_PASS="password" \
-e MYSQL_DB="mydb" \
-- npx -y @benborla29/mcp-server-mysql
</syntaxhighlight>
*: 
* 設定ファイルを使用する場合
** benborla/mcp-server-mysqlの設定例
**: <syntaxhighlight lang="json">
{
"mcpServers": {
"mcp_server_mysql": {
"command": "npx",
"args": ["-y", "@benborla29/mcp-server-mysql"],
"env": {
"MYSQL_HOST": "127.0.0.1",
"MYSQL_PORT": "3306",
"MYSQL_USER": "root",
"MYSQL_PASS": "password",
"MYSQL_DB": "mydb"
}
}
}
}
</syntaxhighlight>
**: 
** designcomputer/mysql_mcp_serverの設定例
**: <syntaxhighlight lang="json">
{
"mcpServers": {
"mysql": {
"command": "uvx",
"args": ["--from", "mysql-mcp-server", "mysql_mcp_server"],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "your_username",
"MYSQL_PASSWORD": "your_password",
"MYSQL_DATABASE": "your_database"
}
}
}
}
</syntaxhighlight>
 
==== OpenCodeでの設定 ====
OpenCodeの設定ファイル (~/.opencode.json) に以下の内容を追記する。 
 
* benborla/mcp-server-mysqlを使用する場合
*: <syntaxhighlight lang="json">
{
"mcpServers": {
"mcp_server_mysql": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@benborla29/mcp-server-mysql"],
"env": {
"MYSQL_HOST": "127.0.0.1",
"MYSQL_PORT": "3306",
"MYSQL_USER": "root",
"MYSQL_PASS": "password",
"MYSQL_DB": "mydb"
}
}
}
}
</syntaxhighlight>
*: 
* designcomputer/mysql_mcp_serverを使用する場合
*: <syntaxhighlight lang="json">
{
"mcpServers": {
"mysql": {
"type": "stdio",
"command": "uvx",
"args": ["--from", "mysql-mcp-server", "mysql_mcp_server"],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "your_username",
"MYSQL_PASSWORD": "your_password",
"MYSQL_DATABASE": "your_database"
}
}
}
}
</syntaxhighlight>
 

== 使用方法 ==
MySQL MCPサーバの各ツールは、AIアシスタントが自然言語の指示を受けて自動的に呼び出す。 
 
==== SQLクエリの実行例 ====
SQLクエリの実行に関する操作例を以下に示す。 
 
* テーブルの全データを取得する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

usersテーブルの全データを取得してください。
</syntaxhighlight>
*: 
* 条件を指定してデータを取得する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

ordersテーブルからステータスが「completed」のレコードを取得してください。
</syntaxhighlight>
*: 
* テーブルの件数を取得する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

productsテーブルのレコード数を教えてください。
</syntaxhighlight>
 
==== テーブル情報の取得例 ====
テーブル構造やデータベース情報の取得に関する操作例を以下に示す。 
 
* データベース内のテーブル一覧を取得する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

このデータベースにどのようなテーブルがありますか？
</syntaxhighlight>
*: 
* テーブルの定義を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

usersテーブルのカラム定義を教えてください。
</syntaxhighlight>
*: 
* テーブル間の関連を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

ordersテーブルとusersテーブルの関係を説明してください。
</syntaxhighlight>
 

== セキュリティ ==
==== benborla/mcp-server-mysql のセキュリティ設定 ====
benborla/mcp-server-mysql は以下のセキュリティ機能を提供する。 
 
<center>
{| class="wikitable"
|+ セキュリティ機能の一覧
! 機能 !! 説明
|-
| 読み取り専用トランザクション（デフォルト） || デフォルトでSELECT操作のみ許可し、データ変更は環境変数で明示的に許可が必要
|-
| プリペアドステートメント || SQLインジェクション攻撃を防ぐためにプリペアドステートメントを使用
|-
| レート制限 || 環境変数 <code>MYSQL_RATE_LIMIT</code> で分あたりのクエリ数を制限できる。
|-
| コネクション暗号化 || 環境変数 <code>MYSQL_SSL</code> でSSL/TLS接続を有効化できる。
|-
| スキーマ保護 || DROP、TRUNCATE、ALTER等の破壊的なDDL操作はデフォルトで禁止
|-
| きめ細かいアクセス制御 || INSERT、UPDATE、DELETE、DDL操作を個別の環境変数で制御できる。
|}
</center>
 
==== designcomputer/mysql_mcp_server のセキュリティ設定 ====
designcomputer/mysql_mcp_server は以下のセキュリティ機能を提供する。 
 
<center>
{| class="wikitable"
|+ セキュリティのベストプラクティス
! ポイント !! 説明
|-
| 環境変数による認証 || データベース認証情報を設定ファイルに直接記述せず、環境変数で管理する。
|-
| 最小権限の原則 || データベースユーザに必要最小限の権限のみを付与することを推奨
|-
| エラーハンドリングとログ記録 || 包括的なログ機能により、操作の追跡とエラーの特定が容易
|-
| ユーザパーミッション検証 || 接続ユーザの権限を検証してから操作を実行する。
|}
</center>
 
==== セキュリティに関する推奨事項 ====
MySQL MCPサーバを安全に使用するための推奨事項を以下に示す。 
 
* データベースユーザには必要最小限の権限のみを付与する。
* 本番環境では読み取り専用ユーザの使用を推奨する。
* パスワードは強固なものを使用し、設定ファイルへの直接記述を避ける。
* 本番環境ではSSL/TLS接続を有効化する。
* リモートデータベースへのアクセスにはSSHトンネルを使用する。
* 定期的にMCPサーバのバージョンを更新してセキュリティパッチを適用する。
 

== トラブルシューティング ==
==== 共通の問題 ====
下表に、OS問わず発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ 共通トラブルシューティング
! 問題 !! 対処法
|-
| MySQLサーバへの接続エラー || MySQLサーバが起動しているか確認する。 <code>MYSQL_HOST</code>、<code>MYSQL_PORT</code>、<code>MYSQL_USER</code>、パスワードの認証情報が正しいか確認する。
|-
| パーミッションエラー || MySQLユーザが対象データベースへの適切な権限 (SELECT等) を持っているか確認する。 MySQLで SHOW GRANTS FOR 'user'@'host'; を実行して権限を確認する。
|-
| タイムアウトエラー || <code>MYSQL_CONNECT_TIMEOUT</code> および <code>MYSQL_QUERY_TIMEOUT</code> の値を増やす。 ネットワーク接続が安定しているか確認する。
|}
</center>
 
==== benborla/mcp-server-mysql 固有の問題 ====
下表に、benborla/mcp-server-mysql で発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ benborla版のトラブルシューティング
! 問題 !! 対処法
|-
| dotenvパッケージエラーが発生する || 以下のコマンドで実行する。 npx -y -p @benborla29/mcp-server-mysql -p dotenv mcp-server-mysql
|-
| Server disconnectedが発生する || ログファイルを確認する。 MacOS: ~/Library/Logs/Claude/mcp-server-mysql.log
|-
| Could not connect to MCP serverが発生する || MCPクライアントの設定ファイルの環境変数 <code>PATH</code> に、Node.jsやnpx等の必要なバイナリのパスを追加する。
|-
| npxコマンドが見つからない || Node.js v20以上がインストールされているか確認する。 NVMを使用している場合は、Node.js実行ファイルへの完全なパスを設定ファイルに指定する。
|}
</center>
 
==== designcomputer/mysql_mcp_server 固有の問題 ====
下表に、designcomputer/mysql_mcp_server で発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ designcomputer版のトラブルシューティング
! 問題 !! 対処法
|-
| コレーションエラーが発生する || 環境変数 <code>MYSQL_CHARSET</code> および <code>MYSQL_COLLATION</code> を設定して 文字セットを明示的に指定する。
|-
| 認証エラーが発生する (MySQL 8以降) || MySQL 8以降で <code>caching_sha2_password</code> が問題になる場合、 対象ユーザの認証プラグインを <code>mysql_native_password</code> に変更する。 例: ALTER USER 'user'@'host' IDENTIFIED WITH mysql_native_password BY 'password';
|-
| デバッグが必要な場合 || MCP Inspectorを使用してサーバの動作をテスト・トラブルシューティングできる。
|-
| uvxコマンドが見つからない || uvパッケージマネージャーがインストールされているか確認する。 pip install uv でインストールできる。
|}
</center>
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,MySQL,MCP,Model Context Protocol,MCPサーバ,Claude,AI,データベース,SQL,Node.js,Python
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - MySQL - 版の履歴