Mysql MCP Server Tdc

🚀 MySQL MCP サーバー

MySQL MCP サーバーは、MySQL データベースとのやり取りを行うためのモデルコンテキストプロトコル（MCP）サーバーです。このサーバーを使用すると、MCP クライアント（AI アシスタントなど）が設定された MySQL データベース内のデータを照会および変更できます。

🚀 クイックスタート

MySQL MCP サーバーを使用することで、MCP クライアントが MySQL データベースとのやり取りを行えます。サーバーを使用する前に、必要な環境変数を設定し、インストールと構築を行う必要があります。

✨ 主な機能

• 標準の接続パラメータを使用して MySQL データベースに接続します。
• MCP ツールを提供し、SQL クエリとステートメントを実行できます。
• 読み取り専用クエリ (SELECT, SHOW, DESCRIBE) をサポートします。
• 環境変数（MYSQL_ALLOW_WRITE_OPS）を使用して書き込み操作 (INSERT, UPDATE, DELETE) をサポートします。この変数を true に設定すると、これらの操作が有効になります。デフォルトでは無効（書き込み操作不可）です。注意： 書き込み操作を有効にすると、MCP クライアントがデータベースを変更できるようになります。慎重に使用してください。
• 標準入出力（stdio）を介して通信します。

📦 インストール

# プロジェクトの依存関係としてインストール（他のプロジェクトで使用する場合を推奨）
npm install

# または、独立したグローバルツールとして必要な場合：
# 1. プロジェクトをビルド：
#    npm run build
# 2. グローバルにリンク：
#    npm link 
#    （または、公開されている場合は `npm install -g .` を使用）

📚 ドキュメント

設定

このサーバーは、データベース接続に以下の環境変数の設定が必要です。

• MYSQL_HOST：MySQL サーバーのホスト名または IP アドレス。
• MYSQL_USER：データベースに接続するためのユーザー名。
• MYSQL_PASSWORD：指定されたユーザーのパスワード。
• MYSQL_DATABASE：接続するデータベースの名前。
• MYSQL_PORT：（オプション）MySQL サーバーのポート番号（デフォルトは 3306）。
• MYSQL_ALLOW_WRITE_OPS：（オプション）insert、update、および delete ツールを有効にするには true に設定します。デフォルトは false（書き込み操作無効）です。注意： 書き込み操作を有効にすると、MCP クライアントがデータベースを変更できるようになります。慎重に使用してください。

これらの変数は、サーバープロセスが実行される環境で使用可能である必要があります。設定方法は、オペレーティングシステムとサーバーの実行方法（例：.env ファイル、システム環境変数、シェルエクスポート）によって異なります。

使用方法

設定が完了し、構築（npm run build）が行われた後、サーバーを実行できます。

# グローバルにリンクされている場合
mysql-server

# または、node を直接使用して実行
node build/index.js 

サーバーが起動すると、stderr に MySQL MCP サーバーが stdio で実行中 と表示され、標準入出力で MCP リクエストを待機します。通常は、MCP クライアント（AI アシスタントの統合など）をこのサーバープロセスに接続するように設定します。

利用可能なツール

サーバーは、MCP クライアントに以下のツールを公開しています。

1. query

• 説明： 設定されたデータベースに対して読み取り専用の SQL クエリ（SELECT, SHOW, DESCRIBE）を実行します。
• 入力モード：

{
  "type": "object",
  "properties": {
    "sql": {
      "type": "string",
      "description": "実行する読み取り専用の SQL クエリ (SELECT, SHOW, DESCRIBE)。"
    }
  },
  "required": ["sql"]
}

• 出力： クエリ結果は、MCP レスポンスの content で JSON 文字列として返されます。クエリが読み取り専用でない場合、またはデータベースエラーが発生した場合は、エラーが返されます。

2. insert

• 説明： INSERT SQL ステートメントを実行します。MYSQL_ALLOW_WRITE_OPS を true に設定する必要があります。
• 入力モード：

{
  "type": "object",
  "properties": {
    "sql": {
      "type": "string",
      "description": "実行する INSERT SQL ステートメント。"
    }
  },
  "required": ["sql"]
}

• 出力： 成功時は挿入されたレコード数を含むメッセージが返され、失敗時はエラーメッセージが返されます。

3. update

• 説明： UPDATE SQL ステートメントを実行します。MYSQL_ALLOW_WRITE_OPS を true に設定する必要があります。
• 入力モード：

{
  "type": "object",
  "properties": {
    "sql": {
      "type": "string",
      "description": "実行する UPDATE SQL ステートメント。"
    }
  },
  "required": ["sql"]
}

• 出力： 成功時は更新されたレコード数を含むメッセージが返され、失敗時はエラーメッセージが返されます。

⚠️ 重要提示

書き込み操作を有効にすると、MCP クライアントがデータベースを変更できるようになります。慎重に使用してください。