mysqldb-mcp-server MCP server

mysqldb-mcp-server MCP サーバー

MySQL データベース用の MCP サーバープロジェクトです。

インストール

uv を使用してパッケージをインストールできます。

uv pip install mysqldb-mcp-server

または、pip を使用します。

pip install mysqldb-mcp-server

コンポーネント

ツール

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

• connect_database：指定した MySQL データベースに接続します

  • database パラメーター：接続するデータベースの名前（文字列）
  • 接続に成功すると、確認メッセージを返します

• execute_query：MySQL クエリを実行します

  • query パラメーター：実行する SQL クエリ（文字列）
  • クエリ結果を JSON 形式で返します
  • セミコロンで区切って複数のクエリを送信できます

設定

サーバーでは、次の環境変数を使用します。

• MYSQL_HOST：MySQL サーバーのアドレス（デフォルト："localhost"）
• MYSQL_USER：MySQL のユーザー名（デフォルト："root"）
• MYSQL_PASSWORD：MySQL のパスワード（デフォルト："")
• MYSQL_DATABASE：初期データベース（任意）
• MYSQL_READONLY：読み取り専用モード（有効にするには 1/true を設定。デフォルト：false）

クイックスタート

インストール

Claude Desktop

MacOS：~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mysqldb-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/burakdirin/Projects/mysqldb-mcp-server",
        "run",
        "mysqldb-mcp-server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "password",
        "MYSQL_DATABASE": "[optional]",
        "MYSQL_READONLY": "true"
      }
    }
  }
}

{
  "mcpServers": {
    "mysqldb-mcp-server": {
      "command": "uvx",
      "args": [
        "mysqldb-mcp-server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "password",
        "MYSQL_DATABASE": "[optional]",
        "MYSQL_READONLY": "true"
      }
    }
  }
}

Smithery 経由でインストール

Smithery 経由で、Claude Desktop 用の MySQL Database Integration Server を自動的にインストールするには：

npx -y @smithery/cli install @burakdirin/mysqldb-mcp-server --client claude

開発

ビルドと公開

配布用にパッケージを準備するには：

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. パッケージの配布物をビルドします。

uv build

これにより、dist/ ディレクトリにソース配布物と wheel 配布物が作成されます。

3. PyPI に公開します。

uv publish

注：環境変数またはコマンドフラグで PyPI の認証情報を設定する必要があります。

• トークン：--token または UV_PUBLISH_TOKEN
• またはユーザー名／パスワード：--username／UV_PUBLISH_USERNAME および --password／UV_PUBLISH_PASSWORD

デバッグ

MCP サーバーは stdio 経由で実行されるため、デバッグが難しい場合があります。最適なデバッグ体験のために、MCP Inspector の使用を強くおすすめします。

次のコマンドを使用して、npm 経由で MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory /Users/burakdirin/Projects/mysqldb-mcp-server run mysqldb-mcp-server

起動すると、Inspector に URL が表示されます。その URL にブラウザーからアクセスして、デバッグを開始できます。