F4ww4z MCP Mysql Server

🚀 @f4ww4z/mcp-mysql-server

このサーバーは、AIモデルが標準インターフェースを介してMySQLデータベースと相互作用できるようにする、モデルコンテキストプロトコル（Model Context Protocol, MCP）サーバーです。

🚀 クイックスタート

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

✨ 主な機能

• 安全な接続処理と自動クリーンアップ
• SQLインジェクション防止のためのプリペアドステートメントのサポート
• 包括的なエラー処理と検証
• TypeScriptのサポート
• 自動接続管理

📦 インストール

Smitheryを使用したインストール

Smitheryを通じて、Claude Desktop用のMySQL Serverを自動インストールできます。

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

手動インストール

npx @f4ww4z/mcp-mysql-server

📚 ドキュメント

設定

サーバーは、MCP設定構成ファイルで以下の環境変数を設定する必要があります。

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@f4ww4z/mcp-mysql-server"],
      "env": {
        "MYSQL_HOST": "your_host",
        "MYSQL_USER": "your_user",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

利用可能なツール

1. connect_db

提供された資格情報を使用してMySQLデータベースに接続します。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "connect_db",
  arguments: {
    host: "localhost",
    user: "your_user",
    password: "your_password",
    database: "your_database"
  }
});

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: ["John Doe", "john@example.com"]
  }
});

4. list_tables

データベース内のすべてのテーブルをリストします。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "list_tables",
  arguments: {}
});

5. describe_table

特定のテーブルの構造を取得します。

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

セキュリティ

• プリペアドステートメントを使用してSQLインジェクションを防止
• 環境変数を通じた安全なパスワード処理のサポート
• クエリ実行前の検証
• 完了後の自動接続クローズ

エラー処理

サーバーは一般的な問題に対して詳細なエラーメッセージを提供します。

• 接続失敗
• 無効なクエリ
• 欠落したパラメータ
• データベースエラー

貢献

貢献を歓迎します！ https://github.com/f4ww4z/mcp-mysql-server にプルリクエストを送信してください。

📄 ライセンス

MIT