Provides access to Amazon Managed Prometheus workspaces, enabling listing of workspaces, querying metrics with PromQL, retrieving workspace details and status, and executing Prometheus queries for monitoring and observability data.
Amazon Managed Prometheus MCP Server
An MCP (Model Context Protocol) server that provides access to Amazon Managed Prometheus workspaces using the FastMCP SDK and uv
for fast Python package management.
Features
- List Amazon Managed Prometheus workspaces
- Get workspace details and configuration
- Query metrics from Prometheus workspaces
- Execute PromQL queries
- Get workspace status and metadata
- Fast dependency management with
uv
Prerequisites
- Install uv (if not already installed):
- AWS Credentials: Configure AWS credentials (one of the following):
- AWS CLI:
aws configure
- Environment variables:
AWS_ACCESS_KEY_ID
,AWS_SECRET_ACCESS_KEY
,AWS_REGION
- IAM roles (if running on EC2)
- AWS CLI:
Installation
Quick Start with uv
Development Installation
Alternative Installation Methods
Usage
Running the MCP Server
Testing the Server
Development Commands
Required AWS Permissions
The server requires the following AWS permissions:
Available Tools
list_workspaces
: List all Amazon Managed Prometheus workspacesget_workspace
: Get detailed information about a specific workspacequery_metrics
: Execute PromQL queries against a workspaceget_workspace_status
: Get the current status of a workspace
Configuration
Environment Variables
MCP Client Configuration
Example configuration for MCP clients:
Development with uv
Adding Dependencies
Managing Python Versions
Virtual Environment Management
Project Structure
Performance Benefits with uv
- Fast Installation: Up to 10-100x faster than pip
- Reliable Resolution: Better dependency resolution
- Disk Efficient: Shared package cache
- Reproducible Builds: Lock file ensures consistency
- Cross-Platform: Works on Windows, macOS, and Linux
Troubleshooting
Common Issues
- FastMCP not found:
- AWS Credentials Error:
- Permission Denied:
- Ensure IAM user/role has required AMP permissions
- Check AWS region configuration
Debug Mode
Contributing
- Fork the repository
- Create a feature branch:
git checkout -b feature-name
- Install development dependencies:
uv sync --extra dev
- Make your changes
- Run tests:
uv run pytest
- Run quality checks:
uv run black src/ && uv run ruff check src/
- Commit your changes:
git commit -am 'Add feature'
- Push to the branch:
git push origin feature-name
- Create a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Changelog
v0.1.0
- Initial release
- Basic workspace listing and querying
- AWS authentication support
- Multi-region support
- uv package management integration
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables access to Amazon Managed Prometheus workspaces through natural language queries. Supports listing workspaces, executing PromQL queries, and retrieving workspace details and metrics with AWS authentication.
Related MCP Servers
- AsecurityAlicenseAqualityProvides access to Prometheus metrics and queries through standardized Model Context Protocol interfaces, allowing AI assistants to execute PromQL queries and analyze metrics data.Last updated -5172PythonMIT License
- AsecurityAlicenseAqualityA server that enables LLMs like Claude to query AWS DynamoDB databases through natural language requests, supporting table management, data querying, and schema analysis.Last updated -7666JavaScriptMIT License
- -securityFlicense-qualityA tool that enables access to Prometheus metrics data through a Model Context Protocol server, allowing interaction with monitoring data using natural language.Last updated -Python
- -securityFlicense-qualityA tool that lets users access Prometheus metrics data through a Model Context Protocol server, supporting authentication options for secure data retrieval.Last updated -1Python