Database MCP Servers Setup Guide

データベース MCP サーバーのセットアップガイド

このガイドでは、Amazon Bedrock モデルで使用するために、さまざまな AWS データベースサービス向けの Model Context Protocol（MCP）サーバーをセットアップする方法を説明します。

対応データベース

• Amazon RDS MySQL：SQL データベースサービス
• Amazon DocumentDB：MongoDB 互換のドキュメントデータベース
• Amazon DynamoDB：NoSQL のキー値・ドキュメントデータベース
• Amazon Redshift：データウェアハウスサービス
• Amazon ElastiCache Redis：インメモリーデータストア

前提条件

MCP サーバーをセットアップする前に、以下を用意してください。

1. AWS サービスへのアクセス権と適切な権限
2. 作成済みでアクセス可能なデータベースインスタンス
3. Node.js と npm のインストール
4. Python 3 のインストール
5. Git のインストール
6. Docker のインストール（任意。コンテナ化された MCP サーバー用）

以下を使用して、前提条件を確認し、インストールできます。

chmod +x check_prerequisites.sh
./check_prerequisites.sh

セットアップ手順

1. データベース認証情報の設定

データベースの接続情報を含む認証情報ファイルを作成します。

cp db_credentials_template.sh set_db_credentials.sh

set_db_credentials.sh を編集し、実際のデータベース認証情報を入力します。

2. データベース接続の検証

MCP サーバーをセットアップする前に、データベース接続が機能することを検証します。

chmod +x validate_db_connections.sh
source ./set_db_credentials.sh
./validate_db_connections.sh

このスクリプトは、設定済みのすべてのデータベースへの接続をテストし、問題があれば報告します。

3. MCP サーバーのセットアップ

セキュアなセットアップスクリプトを実行して、すべてのデータベース MCP サーバーをインストールし、設定します。

chmod +x setup_db_mcp_servers_secure.sh
./setup_db_mcp_servers_secure.sh

このスクリプトは以下を実行します。

• 必要なリポジトリをクローンします
• 必要なコンポーネントをビルドします
• MCP 設定を更新します
• MCP サービスを再起動します

4. MCP サーバーのテスト

セットアップ後、すべての MCP サーバーが正しく動作することをテストします。

chmod +x test_mcp_servers.sh
./test_mcp_servers.sh

使用例

MCP サーバーのセットアップが完了すると、MCP フレームワークを通じて Amazon Bedrock モデルで使用できます。プロンプトの例を以下に示します。

MySQL

Show me all tables in the MySQL database.
Run a query to select the first 10 rows from the customers table.
What are the column names and data types in the orders table?

MongoDB／DocumentDB

List all collections in the MongoDB database.
Find documents in the users collection where age is greater than 30.
Show me the schema of the products collection.

DynamoDB

List all tables in DynamoDB.
Get items from the Orders table where CustomerId equals 'CUST001'.
What are the primary key attributes for the Products table?

Redshift

Show me all tables in the Redshift database.
Run a query to analyze sales data by region.
Explain the schema of the customer_transactions table.

Redis

Get all keys in Redis.
What is the value of the key 'session:user123'?
Show me all members of the set 'active_users'.

セキュリティに関する考慮事項

• 認証情報をバージョン管理にコミットしないでください
• 認証情報の管理には AWS Secrets Manager または Parameter Store の使用を検討してください
• 可能な場合は、アクセスキーではなく IAM ロールを使用してください
• データベースユーザーには最小権限のアクセスを実装してください
• MCP サーバーの設定で、適切な読み取り／書き込み権限を設定してください

トラブルシューティング

問題が発生した場合は、以下を確認してください。

1. logs ディレクトリ内のログを確認します
2. 検証スクリプトを使用してデータベースへの接続を確認します
3. 必要な環境変数がすべて設定されていることを確認します
4. MCP サービスが実行中であることを確認します（http://127.0.0.1:7002）
5. Chatbot UI にアクセスできることを確認します（http://localhost:8502）

追加リソース

• MCP プロトコルのドキュメント
• Amazon Bedrock のドキュメント
• AWS データベースサービス