Aws Rds Mysql MCP Server Amazonq Cli

🚀 Amazon Q CLI と MySQL MCP サーバーの統合

このプロジェクトは、AWS RDS MySQL MCP サーバーを Amazon Q CLI と統合する包括的なガイドです。Amazon Q の会話型インターフェースを通じて、自然言語でデータベースと対話することができます。

概要

このプロジェクトでは、Amazon Q CLI を FastMCP MySQL サーバーと連携するように設定する方法を紹介します。これにより、Amazon Q のチャットインターフェースを通じて、自然言語コマンドで AWS RDS MySQL データベースと対話できます。

前提条件

• Python 3.8 以上
• Amazon Q CLI がインストールされ、設定されていること
• AWS RDS MySQL インスタンスまたはローカル MySQL サーバー
• 適切な権限で AWS CLI が設定されていること

📦 インストールとセットアップ

1. Amazon Q CLI のインストール

以下のインストールガイドに従ってください。

• 参考: Installing Amazon Q Developer CLI

2. 仮想環境の作成

# 独立した仮想環境を作成
python3 -m venv venv-mcp

# 仮想環境をアクティブ化
# Linux/macOS:
source venv-mcp/bin/activate

3. 依存関係のインストール

pip3 install fastmcp pymysql boto3 python-dotenv

4. 環境設定

# 環境ファイルのサンプルをコピー
cp .env.example .env

# .env を実際の設定で編集

.env ファイルを以下のように設定します。

# AWS 設定
AWS_REGION=us-east-1
BEDROCK_MODEL_ID=anthropic.claude-3-haiku-20240307-v1:0

# MySQL データベース設定
RDS_HOST=your-mysql-host.amazonaws.com
RDS_PORT=3306
RDS_USER=your-username
RDS_PASS=your-password
RDS_DB=your-database-name

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

• .env ファイルをバージョン管理にコミットしないでください。
• .env を .gitignore ファイルに追加してください。
• 本番環境では AWS IAM ロールを使用してください。
• 定期的にデータベースの資格情報を更新してください。

MCP 設定オプション

Amazon Q CLI は 2 つの MCP 設定モードをサポートしています。（ここではグローバル設定を実装します）

ワークスペース設定

• 適用範囲: ディレクトリ固有
• 保存場所: 作業ディレクトリの /.amazonq/mcp.json
• 使用方法: 設定されたディレクトリから Q CLI コマンドを実行する必要があります。

グローバル設定（推奨）

• 適用範囲: システム全体でアクセス可能
• 保存場所: ~/.aws/amazonq/mcp.json
• 使用方法: 任意のディレクトリから Q CLI コマンドを実行できます。
• 利点: システム再起動後も設定が保持されます。

グローバル MCP のセットアップ（推奨）

1. 設定ディレクトリの作成

# Amazon Q の設定ディレクトリを作成
mkdir -p ~/.aws/amazonq

2. MCP 設定ファイルの作成

~/.aws/amazonq/mcp.json を以下の内容で作成します。

{
  "mcpServers": {
    "rds_mysql_server": {
      "command": "/absolute/path/to/your/venv-mcp/bin/python3",
      "args": [
        "/absolute/path/to/your/fastmcp_server.py"
      ],
      "env": {},
      "timeout": 120000,
      "disabled": false
    }
  }
}

重要: 以下のパスを実際の絶対パスに置き換えてください。

• /absolute/path/to/your/venv-mcp/bin/python3
• /absolute/path/to/your/fastmcp_server.py

3. 設定の検証

q mcp list

期待される出力:

workspace:
  /.amazonq/mcp.json
    (empty)

global:
  /home/username/.aws/amazonq/mcp.json
    • rds_mysql_server /path/to/venv-mcp/bin/python3

💻 使用例

Amazon Q チャットの起動

q chat

データベースの対話例

# 自然言語クエリ
"Show me all tables in the database"
"Create a users table with id, name, and email columns"
"Find all records in the users table"
"Insert a new user with name 'John Doe' and email 'john@example.com' in users table"
"Show the structure of the users table"

セキュリティ機能

• 入力検証: 悪意のある SQL インジェクションを防止します。
• 操作制限: 危険な操作（DROP DATABASE、TRUNCATE）をブロックします。
• 接続タイムアウト: 120 秒のタイムアウトで、ハングした接続を防止します。
• 環境分離: .env ファイルを通じた安全な資格情報管理。
• エラーハンドリング: 機密情報を公開せずに、適切なエラー応答を返します。

サポートされる操作

トラブルシューティング

一般的な問題

1. MCP サーバーが見つからない場合

   • mcp.json の絶対パスを確認してください。
   • 仮想環境が正しく作成されていることを確認してください。
   • ファイルの権限を確認してください。

2. データベース接続に失敗した場合

   • .env の設定を検証してください。
   • データベースの接続性をテストしてください。
   • ファイアウォールの設定を確認してください。

3. アクセス許可が拒否された場合

   • AWS の資格情報を確認してください。
   • データベースユーザーの権限を確認してください。
   • 適切な IAM ロールが設定されていることを確認してください。

デバッグコマンド

# MCP サーバーを直接テスト
python3 fastmcp_server.py

# 環境変数を確認
echo $AWS_REGION

# Q CLI の設定を確認
q mcp list
q chat --debug

設定管理

MCP サーバーの更新

1. 実行中の Q チャットセッションをすべて停止します。
2. fastmcp_server.py または設定を更新します。
3. Q チャットを再起動します: q chat

MCP サーバーの無効化

{
  "mcpServers": {
    "rds_mysql_server": {
      "disabled": true
    }
  }
}

パフォーマンス最適化

• コネクションプーリング: データベース接続を再利用します。
• クエリキャッシュ: 頻繁にアクセスされるデータをキャッシュします。
• タイムアウト管理: クエリの複雑さに基づいてタイムアウト値を最適化します。
• リソース監視: CPU とメモリの使用状況を監視します。

次のステップ

1. 機能拡張: 特定のビジネスロジック用のカスタムツールを追加します。
2. マルチデータベースサポート: 複数のデータベース接続を設定します。
3. 高度なセキュリティ: ロールベースのアクセス制御を実装します。
4. 監視: ロギングとパフォーマンス監視を設定します。
5. 自動化: チーム環境用のデプロイメントスクリプトを作成します。

注: この設定により、Amazon Q CLI の自然言語インターフェースを通じて、MySQL データベースへの永続的なシステム全体のアクセスが可能になります。データベースの資格情報と接続を扱う際は、常にセキュリティのベストプラクティスに従ってください。