Benborla MCP Server Mysql

🚀 NodeJSベースのMySQL MCPサーバ

このサーバは、MySQLデータベースの読み取り専用アクセスを提供するモデルコンテキストプロトコル（Model Context Protocol, MCP）サーバです。大規模言語モデル（LLMs）がデータベーススキーマを確認し、読み取り専用クエリを実行できるようになります。

✨ 主な機能

ツール

• mysql_query
  • 接続されたデータベースに対する読み取り専用SQLクエリを実行します。
  • 入力：sql（文字列）：実行するSQLクエリ
  • すべてのクエリはREAD ONLYトランザクション内で実行されます。

リソース

サーバは各テーブルのスキーマ情報を提供します。

• テーブル構造
  • 各テーブルのJSONスキーマ情報
  • 列名とデータ型を含みます
  • データベースメタデータから自動的に検出されます

📦 インストール

Claude Desktopを使用するための設定

Claude Desktopアプリでこのサーバを使用するには、claude_desktop_config.jsonファイルの "mcpServers" セクションに以下の設定を追加してください。

{
  "mcpServers": {
    "mcp_server_myqsl": {
      "command": "npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql",
      ],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "db_name"
      }
    }
  }
}

db_name をデータベース名に置き換えるか、すべてのデータベースを取得するには空のままにしてください。

💻 使用例

基本的な使用法

Claude Desktopでの使用例を示します。以下の設定を claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "mcp_server_myqsl": {
      "command": "npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql",
      ],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "db_name"
      }
    }
  }
}

高度な使用法

エラーが発生した場合の設定例です。

{
  "mcpServers": {
    "mcp_server_myqsl": {
      "command": "/path/to/npx/binary/npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql",
      ],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "db_name",
        "PATH": "/path/to/node/bin:/usr/bin:/bin" // この行を追加
      }
    }
  }
}

🔧 トラブルシューティング

「MCPサーバ mcp-server-mysql に接続できません」というエラーが発生した場合は、すべての必須バイナリのパスを明示的に設定する必要がある場合があります。例えば、以下の設定を使用します。

{
  "mcpServers": {
    "mcp_server_myqsl": {
      "command": "/path/to/npx/binary/npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql",
      ],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "db_name",
        "PATH": "/path/to/node/bin:/usr/bin:/bin" // この行を追加
      }
    }
  }
}

📄 ライセンス

このMCPサーバはMITライセンスの下で配布されています。これは、ソフトウェアを自由に使用、変更、配布できることを意味しますが、MITライセンスの条項と条件に従う必要があります。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。