Mysql Database Server Nnk

🚀 @enemyrr/mcp-mysql-server

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

🚀 クイックスタート

📦 インストール

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

Claudeデスクトップ版に適用するMySQLデータベースサーバーをSmitheryを通じて自動インストールします。

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: サーバーを追加”を検索します。
   • 以下の情報を入力します。
     • 名称：mysql
     • タイプ：command
     • コマンド：node /絶対パス/to/mcp-mysql-server/build/index.js

⚠️ 重要提示

/絶対パス/to/mcp-mysql-serverを実際のプロジェクトパスに置き換えてください。

データベース設定

• データベースURL環境変数の使用：

  DATABASE_URL=mysql://ユーザー名:パスワード@ホスト:ポート/データベース名
  

• 個別パラメータ設定：

  • ユーザー名：DB_USERを通じて、またはURLから解析します。
  • パスワード：DB_PASSを通じて、またはURLから解析します。
  • ホスト：DB_HOSTを通じて、またはURLから解析します。
  • ポート：DB_PORTを通じて、またはURLから解析します。デフォルトは3306です。
  • データベース名：DB_NAMEを通じて、またはURLから解析します。

• 直接接続ツール：

  {
    "driver": "mysql",
    "options": {
      "host": "ホストアドレス",
      "port": ポート番号,
      "database": "データベース名",
      "username": "ユーザー名",
      "password": "パスワード"
    }
  }
  

💻 使用例

基本的な使用法

クエリの実行

/**
 * @param {string} query SQLクエリ文
 * @param {any[]} parameters クエリパラメータの配列
 */
async function executeQuery(query, parameters) => Promise<void>

クエリ結果セットの取得

/**
 * @param {string} query SQLクエリ文
 * @param {any[]} parameters クエリパラメータの配列
 */
async function queryResultSet(query, parameters) => Promise<Row[]>

✨ 主な機能

• 複数の接続方式（URL、ワークスペース、直接）をサポートします。
• 安全な接続処理と自動クリーンアップ機能を提供します。
• SQLインジェクションを防止するためのプリコンパイル文をサポートします。
• データベーステーブル構造管理ツールを備えています。
• 完全なエラー処理と検証メカニズムを備えています。
• TypeScriptをサポートします。
• ワークスペースを自動検出します。

🔧 技術詳細

セキュリティ

• プリコンパイル文を使用してSQLインジェクション攻撃を防止します。
• 環境変数を通じてパスワードを安全に処理します。
• クエリを実行する前に検証します。
• 実行完了後に自動的に接続を閉じます。

エラー処理

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

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

🤝 貢献

コミュニティからの貢献を歓迎します！GitHubリポジトリにアクセスしてPull Requestを提出してください。

📄 ライセンス

MIT