MySQL MCP Server

MySQL MCP サーバー

FastMCP 2.0 と Python で実装された MySQL Model Context Protocol（MCP）サーバーです。

特長

• MCP 関数を通じて SQL クエリを実行します
• データベースのスキーマ情報を取得します
• Docker と docker-compose で完全にコンテナ化されています
• 依存関係の管理には Poetry を使用しています

MCP ツール

サーバーは次の MCP ツールを提供します。

• execute_query：SQL クエリを実行して結果を返します
• execute_update：更新／挿入 SQL クエリを実行します
• get_tables：データベース内のテーブル一覧を取得します
• get_table_schema：指定したテーブルのスキーマ情報を取得します
• describe_database：データベース構造の包括的な情報を取得します

セットアップ

前提条件

• Docker と docker-compose
• Poetry（ローカル開発用）
• Python 3.13 以降

Cursor との連携

Cursor と連携するには、次の内容を ~/.cursor/mcp.json ファイルに追加します。

{
  "mcpServers": {
    "mysqlMcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MYSQL_HOST",
        "-e",
        "MYSQL_PORT",
        "-e",
        "MYSQL_USER",
        "-e",
        "MYSQL_PASSWORD",
        "-e",
        "MYSQL_DATABASE",
        "mysql-mcp-server"
      ],
      "env": {
        "MYSQL_HOST": "host.docker.internal",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "password",
        "MYSQL_DATABASE": "mcpdb"
      }
    }
  }
}

Docker イメージのビルド

Docker イメージを個別にビルドするには、次のコマンドを実行します。

docker build -t mysql-mcp-server .