Mysql MCP Server

🚀 @davewind/mysql-mcp-server

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

🚀 クイックスタート

このサーバーを使用することで、大型言語モデルがMySQLデータベースのスキーマを調査し、読み取り専用のクエリを実行できます。以下に、基本的な使用方法を説明します。

✨ 主な機能

1. 読み取り専用のデータベースアクセス：SQL検証と READ ONLY トランザクションにより、読み取り専用操作を強制します。
2. スキーマ発見：データベースのテーブル構造を自動的に識別し、公開します。
3. SQLクエリ実行：SELECT文を受け取り、実行するクエリツールを提供します。
4. モデルコンテキストプロトコル準拠：MCP規格を実装し、互換性のあるLLMとのシームレスな統合を実現します。
5. 簡単な設定：設定が少なく、簡単にセットアップできます。

🛠️ ツール

• query
  • 接続されたデータベースにアクセスするための読み取り専用SQLクエリを実行します。
  • 入力: sql (文字列): 実行するSQLクエリ
  • すべてのクエリは READ ONLY トランザクションで実行されます。

📦 リソース

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

• テーブルスキーマ (mysql://user:password@localhost:port/database)
  • 各テーブルのJSON形式のスキーマ情報
  • 列名とデータ型を含みます
  • データベースのメタデータから自動的に発見されます

📦 インストール

npm install @davewind/mysql-mcp-server -g

⚙️ 設定

MCP設定の設定ファイルです。

推奨設定です。

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@davewind/mysql-mcp-server", "mysql://user:password@localhost:port/database"],
    }
  }
}

🧪 テスト

mysql://user:password@localhost:port/ を置き換えて、npm run inspector を実行します。

  "scripts": {
    "inspector": "npx @modelcontextprotocol/inspector@0.10.2 build/index.js mysql://user:password@localhost:port/database"
  }

💻 環境要件

Node.js v18 +

🔧 技術詳細

システムアーキテクチャ

MySQL MCPサーバーは、LLMとMySQLデータベースの間の仲介役として機能し、MCPプロトコルに基づいてリクエストを処理します。

コンポーネント間の相互作用

（原文で詳細説明がないため、このセクションは省略します。）

セキュリティモデル

MySQL MCPサーバーは、データベースへのアクセスを読み取り専用にするため、厳格なセキュリティモデルを実装しています。

セキュリティ対策には以下のものが含まれます。

1. SQLクエリの検証：SELECT文のみを許可します。
2. すべてのクエリは READ ONLY トランザクションで実行されます。
3. データの変更操作（INSERT、UPDATE、DELETEなど）はサポートされていません。
4. データベーススキーマの変更操作（CREATE、ALTER、DROPなど）はサポートされていません。

統合とLLM

MySQL MCPサーバーは、モデルコンテキストプロトコルをサポートするすべてのLLMシステムと一緒に使用するように設計されています。JSON-RPC over stdioを介してMCP規格に従って通信します。

📄 ライセンス

MIT