Ai2mysql MCP Server

🚀 MySQL MCP サーバー

go-mcp をベースとした MySQL データベース接続サーバーです。stdio を通じてクライアントと通信し、SQL クエリとデータ操作を実行できます。

🚀 クイックスタート

この MySQL MCP サーバーは、MCP プロトコルを使用してクライアントと通信し、MySQL データベースへの接続をサポートします。以下のセクションでは、サーバーのインストール、設定、使用方法について説明します。

✨ 主な機能

• MCP プロトコルを通じたクライアントとの通信
• MySQL データベースへの接続サポート
• クエリ操作（SELECT、SHOW、DESCRIBE）のサポート
• データ操作（INSERT/UPDATE/DELETE）のサポート
• 権限制御（挿入、更新、削除操作を設定可能）
• 柔軟な環境変数設定
• 開発モードでの詳細なログ記録

📦 インストール

方法 1：直接インストール（推奨）

Go の install コマンドを使用して GitHub から直接インストールします。

go install github.com/blanplan-ai/ai2mysql-mcp-server/cmd/ai2mysql-mcp-server@latest

方法 2：手動でビルド

# リポジトリをクローン
git clone https://github.com/blanplan-ai/ai2mysql-mcp-server.git
cd ai2mysql-mcp-server

# サーバーをビルド
go build -o ai2mysql-mcp-server ./cmd/ai2mysql-mcp-server

📚 ドキュメント

設定

サーバーは環境変数を使用して設定されます。

環境変数の説明

使用方法

サーバーの起動

# 基本的な起動
ai2mysql-mcp-server

# 開発モード
IS_DEV=true ai2mysql-mcp-server

Cursor との連携

Cursor でツールを設定する場合は、実行可能ファイルのパスを指定し、対応する環境変数を設定する必要があります。例えば：

{
  "name": "MySQL MCP",
  "command": "/path/to/ai2mysql-mcp-server",
  "env": {
    "MYSQL_HOST": "localhost",
    "MYSQL_PORT": "3306",
    "MYSQL_USER": "root",
    "MYSQL_PASSWORD": "password",
    "DEFAULT_DATABASE": "testdb",
    "ALLOW_INSERT": "true",
    "ALLOW_UPDATE": "true",
    "ALLOW_DELETE": "true",
    "IS_DEV": "false"
  }
}

SQL 操作の実行

• クエリ操作：

echo "mysql_query --sql='SELECT * FROM users'" | ai2mysql-mcp-server

• データ操作：

echo "mysql_execute --sql='INSERT INTO users(name,email) VALUES('John','john@example.com')'" | ai2mysql-mcp-server

開発

プロジェクト構造

ai2mysql-mcp-server/
└── cmd/
    └── ai2mysql-mcp-server/  # サーバーのエントリーポイント
        └── main.go          # メインプログラム

依存関係

• go-sql-driver/mysql：MySQL ドライバー
• ThinkInAIXYZ/go-mcp：MCP プロトコルライブラリ

デバッグとトラブルシューティング

開発モード

環境変数 IS_DEV=true を設定してデバッグモードを有効にします。

IS_DEV=true ai2mysql-mcp-server

デバッグモードでは、サーバーは詳細なログを出力します。受信したすべてのリクエスト、送信したすべてのレスポンス、詳細な SQL クエリと実行情報、エラー条件、およびパフォーマンス関連情報（クエリ実行時間など）が含まれます。

一般的な問題

1. ツールが表示されない：コマンドのパスが正しいことを確認し、実行可能ファイルが存在し、実行権限があることを確認してください。
2. 接続に失敗する：データベースの接続情報が正しいことを確認し、デバッグモードを使用して詳細なエラーメッセージを確認してください。
3. 権限問題：デフォルトではクエリ操作のみが許可されています。挿入、更新、または削除の権限を有効にする必要があるかどうかを確認してください。

📄 ライセンス

MIT License