MCP Mysql Server

🚀 mcp-mysql-server

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

🚀 クイックスタート

このサーバーは、AIモデルがMySQLデータベースとやり取りできるようにするためのものです。以下の手順でセットアップしてください。

📦 インストール

npx @malove86/mcp-mysql-server

📚 ドキュメント

設定

サーバーは2種類のデプロイモードをサポートしています。

1. ローカル実行モード

MCP設定構成ファイルでコマンドラインを使用して実行します。

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

2. リモートURLモード (v0.2.2+)

リモートで実行されているMCPサーバーを指定します。

{
  "mcpServers": {
    "mcp-mysql-server": {
      "url": "http://your-server-address:port/mcp-mysql-server"
    }
  }
}

リモートサーバーでは、環境変数を設定してからMCPサーバーを起動する必要があります。

# 環境変数の設定
export MYSQL_HOST=your_host
export MYSQL_USER=your_user
export MYSQL_PASSWORD=your_password
export MYSQL_DATABASE=your_database
export MYSQL_PORT=3306  # オプション、デフォルトは3306

# サーバーの起動
npx @malove86/mcp-mysql-server

⚠️ 重要提示

MYSQL_PORTはオプションで、デフォルト値は3306です。

バージョン機能

v0.2.4+ 新機能

• 多ユーザー同時接続サポート：サーバーが複数のユーザーからのリクエストを同時に処理できるようになりました。
• 効率的なコネクションプール管理：改良されたコネクションプールを使用し、最大50の同時接続をサポートします。
• リクエストレベルの分離：各リクエストに一意の識別子が付与され、トラッキングとデバッグが容易になります。
• 詳細なログ記録：各リクエストの実行プロセスとリソース使用状況を記録します。
• 改良されたエラー処理：データベースエラーをより正確に捕捉して報告します。
• パフォーマンス最適化：コネクションプールの再利用と最適化された接続管理により、処理速度が向上します。

v0.2.3+ 新機能

• 初期バージョン：データベース接続、クエリ実行などの基本機能を提供します。

利用可能なツール

以下はサーバーが提供する主要なツールです。

1. connect_db

データベース接続を確立するために使用します。

{
  "tool": "connect_db",
  "params": {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "mydb"
  }
}

2. query

データベースクエリを実行します。

{
  "tool": "query",
  "params": {
    "sql": "SELECT * FROM users LIMIT 10"
  }
}

3. list_tables

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

{
  "tool": "list_tables",
  "params": {}
}

4. describe_table

指定されたテーブルの構造を説明します。

{
  "tool": "describe_table",
  "params": {
    "table_name": "users"
  }
}

✨ 主な機能

• 高パフォーマンス：データベース接続とクエリ実行を最適化し、処理速度を向上させます。
• 高可用性：多ユーザーの同時アクセスをサポートし、サービスの安定性を確保します。
• セキュリティ：環境変数を使用して機密情報を管理し、データ漏洩を防止します。
• 拡張性：リモートURLモードをサポートし、デプロイと管理を容易にします。

🔧 技術詳細

パフォーマンス

• 最大同時接続数：50
• 効率的なデータベース操作をサポートし、全体的なパフォーマンスを向上させます。

セキュリティ

• ユーザー分離：異なるユーザー間のデータを独立させ、クロスコンタミネーションを防止します。
• SQLインジェクションの防止：パラメータ化クエリを使用して、セキュリティホールを回避します。
• 権限管理：アクセス権限を制限し、データの安全性を確保します。

🤝 貢献

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

📄 ライセンス

MIT