MySQL MCP Server

MySQL MCP サーバー

自然言語クエリを通じて AI モデルが MySQL データベースを操作するためのインターフェースを提供する、Model Context Protocol（MCP）サーバーです。

概要

このパッケージは、MySQL データベースに接続し、SQL クエリを実行するツールを公開する MCP サーバーを作成します。データベースに直接アクセスすることなく、Claude などの AI モデルが MySQL データベースを操作できるようにします。

前提条件

• Python 3.11 以上
• MySQL データベース

インストール

pip を使って MCP MySQL サーバーをインストールできます。

pip install mcp_mysql_connect

または、UV を使います。

uv pip install mcp_mysql_connect

設定

サーバーには、以下の環境変数が必要です。

• DB_HOST - MySQL サーバーのホスト
• DB_USER - MySQL のユーザー名
• DB_PASSWORD - MySQL のパスワード
• DB_NAME - MySQL データベース名

これらは .env ファイルを使って設定するか、環境に直接設定できます。

使用方法

1. Cursor で使用する

以下を ~/.cursor/mcp.json 設定に追加します。

"mysql-mcp-server": {
  "command": "uvx",
  "args": [
    "--from",
    "mcp_mysql_connect",
    "mcp_mysql_connect"
  ],
  "env": {
    "DB_HOST": "your-mysql-host",
    "DB_USER": "your-username",
    "DB_PASSWORD": "your-password",
    "DB_NAME": "your-database"
  }
}

別の設定方法：

"mysql-mcp-server": {
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp_mysql_connect",
    "-m",
    "mcp_mysql_connect"
  ],
  "env": {
    "DB_HOST": "your-mysql-host",
    "DB_USER": "your-username",
    "DB_PASSWORD": "your-password",
    "DB_NAME": "your-database"
  }
}

2. Python コードで使用する

from mcp.client import Client
from mcp.tools import Tools

# Connect to the MySQL MCP server
tools = Tools()
tools.add_server("mysql", "mcp_mysql_connect")

# Create a client with the tools
client = Client(tools=tools)

# Example query
response = client.complete(
    messages=[
        {"role": "user", "content": "Query all users from the database"}
    ]
)
print(response.content)

3. 手動で実行する

サーバーを手動で起動します。

# Set environment variables first
export DB_HOST=your-mysql-host
export DB_USER=your-username
export DB_PASSWORD=your-password
export DB_NAME=your-database

# Then run the server
python -m mcp_mysql_connect

利用可能なツール

サーバーは、MySQL データベースにクエリを実行するための SQL 実行ツールを提供します。

• read_query(query: str, params: List[str] = None) - データベースに対して SQL SELECT クエリを実行します

クエリの例

Claude やその他の AI モデルを使用する際は、次のような自然言語で質問できます。

• 「先週登録したユーザーをすべて表示してください」
• 「売上上位 5 件の商品は何ですか？」
• 「各顧客が何件の注文をしたか数えてください」

AI モデルは、これらを SQL クエリに変換し、MCP サーバーを使って実行します。

ライセンス

MIT ライセンス

貢献

貢献を歓迎します。お気軽にプルリクエストを送信してください。