Enemyrr MCP Mysql Server

🚀 @enemyrr/mcp-mysql-server

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

🚀 クイックスタート

✨ 主な機能

• URLまたは個別の環境変数による構成をサポートします。
• プリペアドステートメントを使用してSQLインジェクションを防止します。
• トランザクション管理をサポートします。
• 詳細なエラー処理とログ記録を提供します。

📦 インストール

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://ユーザー:パスワード@ホスト:3306/データベース

2. .envで個別のパラメータを使用する：

DB_HOST=localhost
DB_USER=あなたのユーザー
DB_PASSWORD=あなたのパスワード
DB_DATABASE=あなたのデータベース

3. ツールを直接使用して接続する：

use_mcp_tool({
  server_name: "mysql",
  tool_name: "connect_db",
  arguments: {
    url: "mysql://ユーザー:パスワード@ホスト:3306/データベース"
    // または
    workspace: "/パス/to/あなたのプロジェクト" // プロジェクトの.envを使用します
    // または
    host: "localhost",
    user: "あなたのユーザー",
    password: "あなたのパスワード",
    database: "あなたのデータベース"
  }
});

💻 使用例

基本的な使用法

利用可能なツール

1. connect_db

URL、ワークスペースパス、または直接の資格情報を使用してMySQLデータベースに接続します。

2. query

オプションのプリペアドステートメントパラメータ付きでSELECTクエリを実行します。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "query",
  arguments: {
    sql: "SELECT * FROM users WHERE id = ?",
    params: [1]
  }
});

3. execute

オプションのプリペアドステートメントパラメータ付きでINSERT、UPDATE、またはDELETEクエリを実行します。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "execute",
  arguments: {
    sql: "INSERT INTO users (name, email) VALUES (?, ?)",
    params: ["Alice", "alice@example.com"]
  }
});

4. browse_table

データベーステーブルの内容を閲覧します。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "browse_table",
  arguments: {
    table: "users"
  }
});

🔧 技術詳細

セキュリティ

• プリペアドステートメントを使用してSQLインジェクションを防止します。
• 環境変数を使用してパスワードを安全に処理します。
• クエリを実行する前に検証します。
• 接続を自動的に閉じます。

エラー処理

サーバーは以下の状況で詳細なエラー情報を提供します：

• 接続失敗
• 無効なクエリまたはパラメータ
• 構成の欠如
• データベースエラー
• スキーマ検証エラー

🤝 貢献

貢献を歓迎します！自由にPull Requestを https://github.com/enemyrr/mcp-mysql-server に提出してください。

📄 ライセンス

MIT