MCP Server With Claude Ai

🚀 MySQL MCP サーバー

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

⚠️ 重要注意

MySQL MCP サーバーは、独立したサーバーとしてではなく、AI アプリケーションと MySQL データベース間の通信プロトコルの実装コンポーネントとして設計されています。

✨ 主な機能

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

📦 インストール

手動インストール

pip install mysql-mcp-server

Smithery を通じたインストール

Claude デスクトップに MySQL MCP サーバーを自動インストールするには、Smithery を使用します：

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",
        "run",
        "mysql_mcp_server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

高度な使用法

MySQL MCP サーバーは、コマンドラインから直接実行することを想定していませんが、MCP チェックツールを使用してデバッグすることができます：

# 依存関係をインストールする
pip install -r requirements.txt
# MCP チェックツールを使用してデバッグする（Python で直接実行しないでください）

MySQL MCP サーバーは、Claude デスクトップなどの AI アプリケーションと統合するために設計されており、独立した Python プログラムとして実行すべきではありません。

🔧 技術詳細

# リポジトリをクローンする
git clone https://github.com/yourusername/mysql_mcp_server.git
cd mysql_mcp_server
# 仮想環境を作成する
python -m venv venv
source venv/bin/activate  # または Windows では `venv\Scripts\activate`
# 開発用の依存関係をインストールする
pip install -r requirements-dev.txt
# テストを実行する
pytest

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

• 環境変数や認証情報をコミットしないでください
• 最小限の権限を持つデータベースユーザーを使用してください
• 本番環境では、クエリのホワイトリストを実装することを検討してください
• すべてのデータベース操作を監視し、記録してください

💡 セキュリティのベストプラクティス

この MCP 実装は、データベースアクセス権限が必要です。セキュリティを確保するために：

1. 専用の MySQL ユーザーを作成し、最小限の権限を付与してください
2. root アカウントや管理アカウントの使用を避けてください
3. データベースアクセスを必要最小限の操作に制限してください
4. ログ記録を有効にし、監査を行ってください
5. 定期的にセキュリティレビューを行い、データベースアクセスを確認してください

詳細な説明については、MySQL セキュリティ構成ガイド を参照してください：

• 制限付きの MySQL ユーザーを作成する
• 適切な権限を設定する
• データベース接続を監視する
• その他のセキュリティ対策