Registry /
aws / awslabs-mysql-mcp-server
Install & Compatibility
Where this runs
tested against v1.0.21 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
py 3.9
✕ build_error
✕ build_error
127MB installed
● package 127MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
awslabs.mysql-mcp-server
✓ This library is primarily run as a server executable, not typically imported directly into Python applications by end-users. MCP clients (e.g., AI IDEs) invoke it.
The interaction is typically via an MCP client executing the server, not direct Python imports.
The AWS Labs MySQL MCP Server is designed to be executed as a server, which MCP-compatible AI clients connect to. The `uvx` command, as shown above, is the recommended way to run it, optionally specifying connection details for either RDS Data API or direct MySQL. Prior to running, ensure AWS credentials are configured (e.g., via `AWS_PROFILE` environment variable or `aws configure`), and your database credentials are securely stored in AWS Secrets Manager.
# The awslabs.mysql-mcp-server is intended to be run as an executable, often managed by an MCP client or 'uvx'.
# This command starts the server, which an MCP client can then connect to.
# Ensure your AWS credentials (e.g., via AWS_PROFILE) are configured and Secrets Manager
# contains your MySQL credentials.
# Example for RDS Data API connection (replace with your actual ARN and secret name):
# export AWS_PROFILE="your-aws-profile"
# export AWS_REGION="your-aws-region"
# uvx awslabs.mysql-mcp-server@latest \
# --resource_arn "arn:aws:rds:your-aws-region:123456789012:cluster:your-db-cluster" \
# --secret_arn "arn:aws:secretsmanager:your-aws-region:123456789012:secret:your-db-credentials-XXXXXX"
# Example for Direct MySQL connection (replace with your actual host, port, user, and secret name):
# export AWS_PROFILE="your-aws-profile"
# export AWS_REGION="your-aws-region"
# uvx awslabs.mysql-mcp-server@latest \
# --hostname "your-mysql-host.com" \
# --port 3306 \
# --database "your_database_name" \
# --secret_arn "arn:aws:secretsmanager:your-aws-region:123456789012:secret:your-db-credentials-XXXXXX"
mysql-mcp-server --version
Debug
Known issues
breakingServer Sent Events (SSE) support was removed from all MCP servers in their latest major versions, effective May 26th, 2025. This change aligns with the Model Context Protocol specification. Streamable HTTP is planned as a replacement for improved transport capabilities.fixClients should update to use new transport mechanisms as they become available. Review MCP client documentation for compatibility with post-SSE versions.
affects: >=1.0.0 (from May 26, 2025)
gotchaPotential for SQL injection if proper security practices are not followed. Although the MySQL MCP server includes a `mutable_sql_detector.py` for client-side checks, it is crucial to also enforce least-privilege access via server-side IAM/RBAC.fixAlways configure the underlying MySQL database user with minimal necessary permissions (e.g., `SELECT` only if read-only operations are intended). Regularly review database access policies and use the latest MCP server version which includes enhanced client-side checks.
affects: All versions
gotchaThe `awslabs.core-mcp-server` is deprecated. If your setup used this for proxying, you must now configure individual MCP servers (like `awslabs.mysql-mcp-server`) directly in your client application.fixRefer to the MCP client's documentation (e.g., Kiro, Cursor, VS Code) on how to directly configure `awslabs.mysql-mcp-server` without relying on the deprecated core server.
affects: All versions (migration from `awslabs.core-mcp-server`)
Upgrade
Version history
1.0.21latest on PyPI · released May 28, 2026
Audit
Dependencies
pythonrequiredRequires Python 3.10 or newer.
uvoptionalRecommended for installation and running MCP servers.
Aurora MySQL ClusterrequiredTarget database for natural language queries.
AWS Secrets ManagerrequiredRequired for storing database credentials.
AWS RDS Data APIoptionalRequired if using RDS Data API connection method.
DockeroptionalRecommended for running the MCP server locally in a container.