Mysql MCP Server

🚀 MySQL MCP サーバー

MySQL MCP サーバーは、モデルコンテキストプロトコル（MCP）を実装した MySQL の実装です。これにより、AI アプリケーションと MySQL データベース間の安全なやり取りが可能になります。このサーバーコンポーネントは、制御されたインターフェースを通じて、AI アプリケーション（ホスト/クライアント）と MySQL データベース間の通信を促進し、データベースの探索と分析をより安全かつ構造化されたものにします。

🚀 クイックスタート

MySQL MCP サーバーは、AI アプリケーションと MySQL データベース間の通信プロトコルの実装コンポーネントとして機能します。以下のセクションでは、その特性、インストール方法、使用方法などについて詳しく説明します。

✨ 主な機能

• 利用可能な MySQL テーブルをリソースとしてリストアップする
• テーブル内容を読み取る
• エラー処理付きで SQL クエリを実行する
• 環境変数を通じてデータベースへの安全なアクセスを実現する
• 包括的なログ記録を行う

📦 インストール

手動インストール

pip install mysql-mcp-server

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

Smithery を通じて、Claude デスクトップで使用するための MySQL MCP サーバーを自動インストールします。

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

📚 ドキュメント

設定

以下の環境変数を設定してください。

MYSQL_HOST=localhost     # データベースホスト
MYSQL_PORT=3306         # オプション：データベースポート（指定しない場合は 3306 がデフォルト）
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=your_database

使用方法

Claude デスクトップでの使用

claude_desktop_config.json に以下の内容を追加してください。

{
  "mcpServers": {
    "mysql": {
      "command": "uv",
      "args": [
        "--directory", 
        "path/to/mysql_mcp_server",
        "start"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

Visual Studio Code での使用

デバッグをサポートするために launch.json ファイルを設定してください。

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "启动 MySQL MCP 服务器",
      "type": "python",
      "request": "launch",
      "program": "path/to/mysql_mcp_server/__main__.py",
      "args": []
    }
  ]
}

開発

プロジェクトに貢献するには、以下の手順に従ってください。

1. リポジトリをクローンします：git clone https://github.com/yourusername/mysql-mcp-server.git
2. 依存関係をインストールします：pip install -r requirements.txt
3. テスト環境を起動します：pytest tests/

🔧 技術詳細

セキュリティに関する注意事項

• 環境変数や認証情報をバージョン管理システムにコミットしないでください。
• データベース接続を HTTPS で保護してください。
• データベースの認証情報を定期的に更新してください。

ベストプラクティス

• 本番環境では、データベースポートを公開しないでください。
• ファイアウォールを使用してデータベースへのアクセスを制限してください。
• 監査ログを設定して、敏感な操作を監視してください。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。

🔗 貢献ガイド

1. リポジトリをクローンします：git clone https://github.com/yourusername/mysql-mcp-server.git
2. 機能ブランチを作成します：git checkout -b feature/amazing-feature
3. 変更をコミットします：git commit -m '実現する素晴らしい新機能'
4. ブランチにプッシュします：git push origin feature/amazing-feature
5. プルリクエストを提出します

これらの手順に従うことで、プロジェクトの発展に大きく貢献することができます。

⚠️ 重要提示

MySQL MCP サーバーは、独立して動作するサーバーとして設計されておらず、AI アプリケーションと MySQL データベース間の通信プロトコルの実装コンポーネントです。