RDS MCP Server
A Model Context Protocol (MCP) server for monitoring and analyzing Amazon RDS(MySQL, PostgreSQL) instances information, metrics and slowquery logs.
Installation
Install directly from GitHub using pipx:
# Install
pipx install git+https://github.com/neoai-agent/rds-mcp.git
# Or run without installation
pipx run git+https://github.com/neoai-agent/rds-mcp.git
Quick Start
Authentication Options
The server supports multiple AWS authentication methods:
Option 1: IAM Roles (Recommended for EC2/ECS)
When running on AWS infrastructure with IAM roles attached, you can omit AWS credentials:
rds-mcp --openai-api-key "YOUR_OPENAI_API_KEY" --region "YOUR_AWS_REGION"
Option 2: AWS Access Keys
For local development or when IAM roles are not available:
rds-mcp --access-key "YOUR_AWS_ACCESS_KEY" --secret-access-key "YOUR_AWS_SECRET_KEY" --region "YOUR_AWS_REGION" --openai-api-key "YOUR_OPENAI_API_KEY"
Option 3: Environment Variables
You can also set AWS credentials via environment variables:
rds-mcp --access-key "YOUR_AWS_ACCESS_KEY" --secret-access-key "YOUR_AWS_SECRET_KEY" --region "YOUR_AWS_REGION" --openai_api_key "YOUR_OPENAI_API_KEY"
Note: When using IAM roles, the server will automatically use the default AWS credential chain, which includes IAM roles, environment variables, and AWS credentials file.
Available Tools
The server provides the following tools for RDS instance management and monitoring:
- Get RDS instance details:
await get_db_info(
database_name="your-db-instance",
region="your-aws-region"
)
- Get database metrics:
await get_database_metrics(
database_name="your-db-instance",
time_range_minutes=30
)
- Get slow queries:
await get_database_queries(
database_name="your-db-instance",
time_range_minutes=30
)
- Get instance performance metrics:
await get_top_rds_load(
database_name="your-db-instance",
time_range_minutes=30
)
Development
For development setup:
git clone https://github.com/neoai-agent/rds-mcp.git
cd rds-mcp
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -e ".[dev]"
License
MIT License - See LICENSE file for details
Metadata
Release files for iflow-mcp_neoai-agent-rds-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_neoai_agent_rds_mcp-0.1.0.tar.gz | 12.5 kB | Without provenance | Details for iflow_mcp_neoai_agent_rds_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_neoai_agent_rds_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_neoai_agent_rds_mcp-0.1.0-py3-none-any.whl |
Total release size: 23.7 kB
Release files / iflow_mcp_neoai_agent_rds_mcp-0.1.0.tar.gz
| Download URL | iflow_mcp_neoai_agent_rds_mcp-0.1.0.tar.gz |
|---|---|
| Size | 12.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
152201bbbf3e72c998cb21ffda95db1c2f5407d367337f2058c93331fbd790bc
|
|
BLAKE2b-256 checksum How to use checksums |
ef449faf4596c012d9451eb2763e0ce8a1c0df553ea6f1e55ce19a05d9b71e9b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_neoai_agent_rds_mcp-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_neoai_agent_rds_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 11.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d841d83b803c73432210edede579fff959605c3bc7dc539791b107f61cfe6b9c
|
|
BLAKE2b-256 checksum How to use checksums |
5b1e4336253faea8c9e8674bc904acae212ebdfe18e0f5e7ad087f138959b614
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_neoai-agent-rds-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.