Database MCP Servers Setup Guide

数据库 MCP 服务设置指南

本指南介绍如何为各种 AWS 数据库服务设置 Model Context Protocol（MCP）服务，以便与 Amazon Bedrock 模型配合使用。

支持的数据库

• 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 数据库服务