mcp-server-mysql

mcp-server-mysql

MySQL データベース向けの Model Context Protocol サーバーです。このサーバーを使うと、LLM がデータベースのスキーマを調査し、読み取り専用クエリを実行できます。

特長

• MySQL データベースへの読み取り専用アクセス
• スキーマの調査機能
• READ ONLY トランザクション内での安全なクエリ実行
• Docker に対応
• NPM パッケージを利用可能

インストール

Docker を使用する場合

# Build the Docker image
make docker

# Run with Docker
docker run -i --rm mcp/mysql mysql://host:port/dbname

Smithery 経由でインストールする場合

Smithery 経由で、Claude Desktop 用の MySQL Database Server を自動的にインストールするには、次の手順を実行します。

npx -y @smithery/cli install @yuru-sha/mcp-server-mysql --client claude

使用方法

Claude Desktop で使用する場合

claude_desktop_config.json に次の設定を追加します。

{
  "mcpServers": {
    "mysql": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/mysql",
        "mysql://host:port/dbname"
      ]
    }
  }
}

注：macOS で Docker を使用する場合、MySQL サーバーがホストのネットワーク上で実行されているときは、host.docker.internal を使用してください。

接続 URL の形式

mysql://[user][:password]@host[:port]/database

/database をデータベース名に置き換えてください。

開発

# Initial setup
make setup

# Build the project
make build

# Format code
make format

# Run linter
make lint

ライセンス

このプロジェクトは MIT License のもとで公開されています。

セキュリティ

このサーバーは、データベースを保護するため、読み取り専用アクセスを強制します。すべてのクエリは READ ONLY トランザクション内で実行されます。

セキュリティをさらに強化するため、読み取り専用ユーザーを作成することをおすすめします。

コントリビューション

コントリビューションを歓迎します。お気軽に Pull Request を送信してください。