MySQL MCP Server

MySQL MCP サーバー

MySQL データベースに直接アクセスできる強力な MCP サーバーです。このサーバーを使うと、AI エージェントはシンプルなインターフェースを通じて MySQL データベースを操作し、SQL クエリを実行して、データベースのコンテンツを管理できます。

特長

リソース

• note:///{id} URI を介して、データベースに保存されたノートにアクセスできます
• 各ノートにはタイトルとコンテンツがあります
• シンプルにコンテンツへアクセスできるプレーンテキストの MIME タイプ

ツール

• create_note - データベースに新しいテキストノートを作成します
  • タイトルとコンテンツを必須パラメーターとして受け取ります
  • ノートを MySQL データベースに保存します
• list_tables - 接続先データベースのすべてのテーブルを一覧表示します
• count_tables - データベース内のテーブルの合計数を取得します
• search_tables - LIKE パターンを使ってテーブルを検索します
• describe_table - 特定のテーブルの構造を取得します
• execute_sql - カスタム SQL クエリを実行します

前提条件

• Node.js 18 以上
• MySQL サーバーがインストールされ、実行中であること
• 適切な権限を持つデータベース

セットアップ

1. このリポジトリをクローンします：

   git clone [email protected]:LeonMelamud/mysql-mcp.git
   cd mysql-mcp
   

2. 依存関係をインストールします：

   npm install
   

3. ルートディレクトリに MySQL 接続情報を記述した .env ファイルを作成します：

   MYSQL_HOST=localhost
   MYSQL_USER=your_username
   MYSQL_PASSWORD=your_password
   MYSQL_DATABASE=your_database
   

4. サーバーをビルドします：

   npm run build
   

インストール

Claude Desktop の場合

サーバー設定を Claude Desktop の設定ファイルに追加します：

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": ["/path/to/mysql-server/build/index.js"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

Cline の場合

サーバー設定を Cline の MCP 設定ファイルに追加します：

MacOS の場合：~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json Windows の場合：%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": ["/path/to/mysql-server/build/index.js"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

使用例

インストール後、Claude との会話で MySQL MCP サーバーを使用できます：

データベース内のすべてのテーブルを一覧表示する

Please list all the tables in my MySQL database.

SQL クエリを実行する

Run this SQL query: SELECT * FROM users LIMIT 5

ノートを作成する

Create a note titled "Meeting Notes" with the content "Discussed project timeline and assigned tasks."

開発

自動再ビルドを有効にして開発する場合：

npm run watch

デバッグ

MCP Inspector を使ってサーバーをデバッグします：

npm run inspector

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。

ライセンス

MIT