Mysql Database Server

🚀 @enemyrr/mcp-mysql-server

このサーバーは、AIモデルが標準化されたインターフェースを通じてMySQLデータベースとやり取りできるようにする、MySQLデータベース操作を提供するModel Context Protocolサーバーです。

🚀 クイックスタート

📦 インストール

Cursor IDEでのインストールと設定

Smitheryを通じたインストール

Smitheryを通じてClaude DesktopのMySQLデータベースサーバーを自動でインストールするには：

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

手動インストール

1. プロジェクトをクローンしてビルドする：

git clone https://github.com/enemyrr/mcp-mysql-server.git
cd mcp-mysql-server
npm install
npm run build

2. Cursor IDEの設定にサーバーを追加する：
   • コマンドパレット（Cmd/Ctrl + Shift + P）を開く
   • “MCP: Add Server”を検索する
   • 情報を入力する：
     • 名前：mysql
     • タイプ：command
     • コマンド：node /絶対パス/to/mcp-mysql-server/build/index.js

⚠️ 重要提示

/absolute/path/to/ を実際にプロジェクトをクローンしてビルドしたパスに置き換えてください。

データベースの設定

データベース接続は3つの方法で設定できます：

1. .envファイル内のDatabase URL（推奨）：

DATABASE_URL = mysql://username:password@host:port/database

2. 個別のDBパラメータ設定：

DB_HOST = host
DB_USER = username
DB_PASSWORD = password
DB_NAME = database
DB_PORT = port

3. ツールを通じて直接接続し、詳細情報を提供する。

✨ 主な機能

• 複数の接続方法（URL、ワークスペース、直接）をサポート
• 安全な接続処理と自動クリーンアップを提供
• SQLインジェクションを防止するためのprepared statementsをサポート
• Schema管理ツールを提供
• 包括的なエラー処理と検証を備える
• TypeScriptをサポート
• ワークスペースを自動検出

💻 使用例

利用可能なツール

• connect_db：データベース接続を確立するために使用。
• query：クエリを実行し、prepared statementsをサポート。
• execute：非クエリ操作を実行。
• list_tables：すべてのテーブルをリストする。
• get_columns：指定されたテーブルの列情報を取得。
• execute_query：カスタムクエリを実行。
• insert_data：データを挿入。
• update_data：データを更新。
• delete_data：データを削除。

🔧 技術詳細

セキュリティ

• prepared statementsを使用してSQLインジェクションを防止
• 環境変数を通じて安全なパスワード処理をサポート
• 実行前にクエリを検証
• 接続を自動的に閉じる

エラー処理

サーバーは以下の場合に詳細なエラー情報を提供します：

• 接続失敗
• 無効なクエリまたはパラメータ
• 設定が不足している
• データベースエラー
• Schema検証エラー

📄 ライセンス

MIT