MCP AWS Monitor
MCP AWS Monitor
Servidor MCP para monitoreo de infraestructura AWS de Logispot.
Estructura del proyecto
mcp-aws-monitor/
├── .env ← AWS 키 + Google OAuth 키 (git 미추적)
├── .env.example ← .env 템플릿
├── .gitignore
├── pyproject.toml ← 패키지 정의 (mcp, boto3, httpx, uvicorn 등)
├── README.md
└── src/
├── __init__.py
├── server.py ← MCP 서버 진입점 (stdio / HTTP 모드)
├── google_oauth.py ← Google OAuth Provider (HTTP 모드용)
├── aws_client.py ← boto3 클라이언트 팩토리 (lru_cache)
├── cloudwatch.py ← CloudWatch 도구 4개
├── sqs.py ← SQS 도구 3개
├── rds.py ← RDS 도구 3개
├── s3.py ← S3 도구 4개
├── ec2.py ← EC2/ECS/AutoScaling 도구 5개
├── sns.py ← SNS 도구 2개
└── lambda_tools.py ← Lambda 도구 3개Related MCP server: AWS Sage
Métodos de integración
Se puede integrar con Claude Code de dos maneras.
Método 1: stdio (solo local)
Claude Code ejecuta el servidor MCP directamente como un proceso hijo. Solo se puede usar en la misma máquina y no requiere autenticación adicional.
Claude Code --stdio--> MCP 서버 (자식 프로세스)Método de ejecución:
Cambiar la configuración de Claude Code a stdio (ver más abajo)
Se ejecuta automáticamente al iniciar Claude Code (no es necesario iniciar el servidor por separado)
Configuración de Claude Code (~/.claude.json o ~/.claude/.mcp.json):
{
"mcpServers": {
"aws-monitor": {
"command": "/path/to/mcp-aws-monitor/.venv/bin/python",
"args": ["-m", "src.server"],
"cwd": "/path/to/mcp-aws-monitor"
}
}
}CLI de registro:
claude mcp add aws-monitor -s user -- /path/to/mcp-aws-monitor/.venv/bin/python -m src.serverMétodo 2: HTTP + Google OAuth (remoto/multiusuario)
Ejecuta el servidor MCP como un servidor HTTP independiente y autentica con Google OAuth. Si se despliega el servidor en EC2, los miembros del equipo pueden compartirlo.
Claude Code --HTTP--> MCP 서버 (:8000)
↓ (인증 필요)
브라우저 → Google 로그인
↓ (로그인 완료)
/google/callback → MCP 토큰 발급
↓
Claude Code가 토큰으로 MCP 도구 사용Preparación previa:
Crear un cliente OAuth en Google Cloud Console
API y servicios→Pantalla de consentimiento OAuth→ Tipo de usuario: Interno (solo permite la organización de Workspace)Credenciales→ID de cliente OAuth→ Aplicación webURI de redirección autorizado:
http://{dirección del servidor}:8000/google/callback
Agregar a
.env:GOOGLE_CLIENT_ID=xxx.apps.googleusercontent.com GOOGLE_CLIENT_SECRET=GOCSPX-xxx MCP_SERVER_URL=http://localhost:8000 # 배포 시 실제 서버 URL로 변경
Método de ejecución:
Cambiar la configuración de Claude Code a http (ver más abajo)
Ejecutar el servidor MCP directamente:
cd /path/to/mcp-aws-monitor .venv/bin/python -m src.server --http # Uvicorn running on http://0.0.0.0:8000Iniciar (o reiniciar) Claude Code
Al invocar una herramienta MCP, se abrirá el navegador y se autenticará automáticamente después de iniciar sesión en Google
Para detener el servidor: Ctrl+C
Configuración de Claude Code (~/.claude.json o ~/.claude/.mcp.json):
{
"mcpServers": {
"aws-monitor": {
"type": "http",
"url": "http://localhost:8000/mcp"
}
}
}CLI de registro:
claude mcp add --transport http -s user aws-monitor http://localhost:8000/mcpPrecauciones:
Si la pantalla de consentimiento OAuth de Google se configura como "Interna", solo las cuentas de la misma organización de Google Workspace pueden acceder
El token se almacena en memoria, por lo que se requiere volver a iniciar sesión si se reinicia el servidor
localhostsolo es accesible desde la propia máquina. Para compartir en equipo, es necesario desplegar el servidor
Arquitectura
Flujo de operación (stdio)
Claude Code 세션 시작
→ MCP 서버 프로세스 실행 (src/server.py)
→ .env에서 AWS 키 로드 (python-dotenv)
→ FastMCP 인스턴스 생성
→ 각 모듈의 register_tools()로 도구 24개 등록
→ stdio 기반으로 Claude Code와 통신Flujo de operación (HTTP + Google OAuth)
MCP 서버 실행 (uvicorn :8000)
→ .env에서 AWS 키 + Google OAuth 키 로드
→ FastMCP 인스턴스 생성 (AuthSettings 포함)
→ OAuth 엔드포인트 자동 마운트 (/authorize, /token, /register, /revoke)
→ /google/callback 라우트 추가
→ /mcp 엔드포인트에서 인증된 요청만 도구 실행aws_client.py
Fábrica que almacena en caché los clientes boto3 con lru_cache.
Crea y reutiliza un cliente una sola vez para el mismo servicio.
Se invoca con get_client("nombre del servicio") desde todos los módulos.
Patrón de módulos
Todas las herramientas siguen el mismo patrón:
Obtener el cliente boto3 con
get_client()Llamar a la API de AWS
Convertir la respuesta a una cadena con formato en coreano y devolverla
Las herramientas MCP deben devolver un valor de tipo cadena, por lo que todas son -> str.
Herramientas proporcionadas (24)
CloudWatch (4)
cloudwatch_get_alarms
Consulta el estado de las alarmas de CloudWatch.
state_filter(str, por defecto "ALL"): ALARM, OK, INSUFFICIENT_DATA, ALLConsulta tanto MetricAlarms como CompositeAlarms
Devuelve el nombre de la alarma, la métrica asociada y el motivo del cambio de estado
cloudwatch_get_metric
Consulta datos de series temporales de una métrica específica.
namespace(str): Espacio de nombres de AWS (ej: AWS/EC2, AWS/RDS)metric_name(str): Nombre de la métrica (ej: CPUUtilization)dimension_name(str): Nombre de la dimensión (ej: InstanceId)dimension_value(str): Valor de la dimensión (ej: i-0abc123)stat(str, por defecto "Average"): Average, Sum, Maximum, Minimum, SampleCounthours(int, por defecto 1): Rango de tiempo de consulta en horasEl período se calcula automáticamente con un mínimo de 5 minutos y un máximo de 60 puntos de datos
cloudwatch_search_logs
Ejecuta una consulta de CloudWatch Logs Insights.
log_group(str): Nombre del grupo de logs (ej: /ecs/logispot-api)query(str): Consulta de Insightshours(int, por defecto 1): Rango de tiempo de consulta en horaslimit(int, por defecto 50): Límite de resultadosConsulta asíncrona → sondea cada 1 segundo durante un máximo de 30 segundos esperando la finalización
Si la consulta no tiene una cláusula limit, se agrega automáticamente
cloudwatch_list_log_groups
Lista los grupos de logs de CloudWatch.
prefix(str, opcional): Filtro por prefijo del nombre del grupo de logsObtiene la lista completa con un paginador
Muestra el tamaño de almacenamiento (MB) de cada grupo de logs
SQS (3)
sqs_list_queues
Lista las colas SQS y consulta el número de mensajes.
prefix(str, opcional): Filtro por prefijo del nombre de la colaMuestra el número de mensajes en espera (Visible), en proceso (NotVisible) y retrasados (Delayed) por cola
sqs_queue_detail
Consulta información detallada de una cola SQS.
queue_name(str): Nombre de la colaMuestra ARN, número de mensajes, VisibilityTimeout, MessageRetentionPeriod
Si existe RedrivePolicy, analiza y muestra el nombre de la DLQ y maxReceiveCount
sqs_peek_messages
Previsualiza mensajes de una cola SQS sin eliminarlos.
queue_name(str): Nombre de la colacount(int, por defecto 5): Número de mensajes a consultar (máximo 10)Llama con VisibilityTimeout=0 para que los mensajes sean visibles inmediatamente de nuevo
Muestra hasta 500 caracteres del cuerpo del mensaje
RDS (3)
rds_list_instances
Lista las instancias RDS y su estado.
Sin parámetros
Muestra por instancia: identificador, estado, motor/versión, clase, almacenamiento, Multi-AZ, Endpoint
rds_get_metrics
Consulta las métricas principales de una instancia RDS. Utiliza la API de CloudWatch.
db_instance_id(str): Identificador de la instancia RDShours(int, por defecto 1): Rango de tiempo de consulta en horas7 métricas consultadas:
CPUUtilization (%)
DatabaseConnections (número)
FreeStorageSpace (convertido a GB)
ReadLatency / WriteLatency (segundos)
ReadIOPS / WriteIOPS
Devuelve el valor del punto de datos más reciente de cada métrica
rds_slow_queries
Consulta las Top N consultas lentas con Performance Insights de RDS.
db_instance_id(str): Identificador de la instancia RDShours(int, por defecto 1): Rango de tiempo de consulta en horaslimit(int, por defecto 10): Número de resultadosObtiene DbiResourceId con la API de RDS → consulta el ranking de consultas basado en db.load.avg con la API de PI
Devuelve un resultado vacío para instancias con Performance Insights deshabilitado
S3 (4)
s3_list_buckets
Lista los buckets de S3.
Sin parámetros
Muestra el nombre del bucket y la fecha de creación
s3_list_objects
Lista los objetos dentro de un bucket de S3.
bucket(str): Nombre del bucketprefix(str, opcional): Prefijo de ruta (ej: logs/2024/)limit(int, por defecto 30): Número de resultadosPrimero recorta con MaxKeys y luego ordena por LastModified en orden descendente
Conversión automática del tamaño del archivo a KB/MB
s3_get_bucket_size
Calcula el tamaño total de un bucket de S3 o un prefijo.
bucket(str): Nombre del bucketprefix(str, opcional): Prefijo de rutaItera sobre todos los objetos con un paginador y los suma
Devuelve el número de archivos y el tamaño total (con conversión automática a KB/MB/GB)
Los buckets grandes pueden tardar mucho tiempo
s3_read_text_file
Lee el contenido de un archivo de texto de S3.
bucket(str): Nombre del bucketkey(str): Clave del archivomax_bytes(int, por defecto 10000): Máximo de bytes a leerLee solo la parte inicial con el encabezado Range (seguro para archivos grandes)
Decodifica con UTF-8, los caracteres rotos se reemplazan
EC2 / ECS / AutoScaling (5)
ec2_list_instances
Lista las instancias EC2.
state_filter(str, por defecto "running"): running, stopped, allMuestra la etiqueta Name, ID de instancia, tipo, estado, AZ, IP privada/pública
ec2_get_cpu
Consulta la serie temporal de uso de CPU de una instancia EC2.
instance_id(str): ID de la instancia EC2hours(int, por defecto 1): Tiempo de consulta en horasMuestra dos estadísticas juntas: Average y Maximum
ecs_list_clusters
Lista los clústeres de ECS.
Sin parámetros
Muestra por clúster: estado, número de servicios activos, número de tareas en ejecución/en espera
ecs_list_services
Lista los servicios dentro de un clúster de ECS y su estado.
cluster(str): Nombre o ARN del clústerMuestra por servicio: estado, conteos Desired/Running/Pending, Task Definition
autoscaling_list_groups
Lista los grupos de Auto Scaling y su estado actual.
Sin parámetros
Muestra por grupo: número de instancias, configuración Min/Max/Desired, tipo de health check
SNS (2)
sns_list_topics
Lista los temas de SNS.
Sin parámetros
Muestra el nombre del tema y el ARN
sns_get_topic_subscriptions
Lista las suscripciones de un tema de SNS.
topic_arn(str): ARN del tema (ej: arn:aws:sns:ap-northeast-2:123456:my-topic)Muestra por suscripción: Protocol, Endpoint, SubscriptionArn
Lambda (3)
lambda_list_functions
Lista las funciones Lambda.
Sin parámetros
Muestra el nombre de la función, Runtime, Description, LastModified
lambda_get_function
Consulta información detallada de una función Lambda.
function_name(str): Nombre o ARN de la funciónMuestra información de configuración (Runtime, Handler, Memory, Timeout), claves de variables de entorno, mapeo de fuentes de eventos y política de recursos
lambda_get_code
Consulta el código fuente de una función Lambda.
function_name(str): Nombre o ARN de la funciónDescarga el paquete de implementación y muestra el contenido de los archivos fuente (.py, .js, .ts, .json, etc.)
Excluye directorios de dependencias como node_modules, pycache, etc.
Instalación
cd ~/work/mcp-aws-monitor
python3 -m venv .venv
source .venv/bin/activate
pip install -e .Configuración
Ingrese las claves necesarias en el archivo .env:
# AWS (필수)
AWS_ACCESS_KEY_ID=your-key
AWS_SECRET_ACCESS_KEY=your-secret
AWS_DEFAULT_REGION=ap-northeast-2
# Google OAuth (HTTP 모드 사용 시)
GOOGLE_CLIENT_ID=xxx.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-xxx
MCP_SERVER_URL=http://localhost:8000Consulte la sección Métodos de integración anterior para conocer cómo integrar con Claude Code.
Permisos IAM
Al crear un usuario IAM, adjunte la siguiente política en línea:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"cloudwatch:Describe*",
"cloudwatch:Get*",
"logs:Describe*",
"logs:StartQuery",
"logs:GetQueryResults",
"sqs:List*",
"sqs:Get*",
"sqs:ReceiveMessage",
"rds:Describe*",
"pi:Describe*",
"s3:List*",
"s3:Get*",
"ec2:Describe*",
"ecs:List*",
"ecs:Describe*",
"autoscaling:Describe*",
"lambda:List*",
"lambda:Get*",
"lambda:GetPolicy",
"sns:List*",
"sns:Get*"
],
"Resource": "*"
}
]
}Consola de AWS → IAM → Usuarios → Crear usuario
Configuración de permisos → "Adjuntar políticas directamente" → Pegue la política anterior en la pestaña JSON
Después de crear el usuario, emita una clave de acceso (para uso CLI)
Ingrese la clave en
.env
Limitaciones conocidas
Solo admite una región (ap-northeast-2). No es posible consultar múltiples regiones
Al listar EC2, RDS y AutoScaling, solo se devuelve la primera página (se trunca con grandes cantidades de recursos)
s3_list_objectsaplica el límite después de la ordenación básica de S3, por lo que puede no ser el N más reciente realSi la consulta de
cloudwatch_search_logsno se completa en 30 segundos, puede devolver resultados incompletosEn caso de error de la API de AWS, la excepción se expone directamente (falta de permisos, ID de recurso incorrecto, etc.)
Available Tools
19 toolsautoscaling_list_groupsC
Auto Scaling 그룹 목록 및 현황 조회.
Inputs: no named parameters. Returns: result
cloudwatch_get_alarmsB
CloudWatch 알람 상태 조회. state_filter: ALARM, OK, INSUFFICIENT_DATA, ALL (기본값)
Inputs: state_filter. Returns: result
cloudwatch_get_metricB
CloudWatch 메트릭 데이터 조회. 예시: namespace=AWS/EC2, metric_name=CPUUtilization, dimension_name=InstanceId, dimension_value=i-xxx stat: Average, Sum, Maximum, Minimum, SampleCount hours: 조회할 시간 범위 (기본 1시간)
Inputs: namespace (required), metric_name (required), dimension_name (required), dimension_value (required), +2 more. Returns: result
cloudwatch_list_log_groupsA
CloudWatch 로그 그룹 목록 조회. prefix: 로그 그룹 이름 접두사 필터 (선택)
Inputs: prefix. Returns: result
cloudwatch_search_logsA
CloudWatch Logs Insights 쿼리 실행. log_group: 로그 그룹 이름 (예: /ecs/logispot-api) query: Insights 쿼리 (예: 'fields @timestamp, @message | filter @message like /ERROR/') hours: 조회 시간 범위 (기본 1시간) limit: 결과 수 제한 (기본 50)
Inputs: query (required), log_group (required), hours, limit. Returns: result
ec2_get_cpuC
EC2 인스턴스 CPU 사용률 조회. instance_id: EC2 인스턴스 ID hours: 조회 시간 (기본 1시간)
Inputs: instance_id (required), hours. Returns: result
ec2_list_instancesB
EC2 인스턴스 목록 조회. state_filter: running, stopped, all (기본 running)
Inputs: state_filter. Returns: result
ecs_list_clustersA
ECS 클러스터 목록 조회.
Inputs: no named parameters. Returns: result
ecs_list_servicesA
ECS 클러스터 내 서비스 목록 및 상태 조회. cluster: 클러스터 이름 또는 ARN
Inputs: cluster (required). Returns: result
rds_get_metricsB
RDS 인스턴스 주요 메트릭 조회 (CPU, 커넥션, 읽기/쓰기 지연시간). db_instance_id: RDS 인스턴스 식별자 hours: 조회 시간 범위 (기본 1시간)
Inputs: db_instance_id (required), hours. Returns: result
rds_list_instancesC
RDS 인스턴스 목록 및 상태 조회.
Inputs: no named parameters. Returns: result
rds_slow_queriesB
RDS Performance Insights로 슬로우 쿼리 Top N 조회. db_instance_id: RDS 인스턴스 식별자 hours: 조회 시간 범위 (기본 1시간) limit: 결과 수 (기본 10)
Inputs: db_instance_id (required), hours, limit. Returns: result
s3_get_bucket_sizeC
S3 버킷(또는 prefix) 총 크기 계산. bucket: 버킷 이름 prefix: 경로 접두사 (선택)
Inputs: bucket (required), prefix. Returns: result
s3_list_bucketsB
S3 버킷 목록 조회.
Inputs: no named parameters. Returns: result
s3_list_objectsA
S3 버킷 내 객체 목록 조회 (최신순). bucket: 버킷 이름 prefix: 경로 접두사 (예: logs/2024/) limit: 결과 수 (기본 30)
Inputs: bucket (required), limit, prefix. Returns: result
s3_read_text_fileB
S3 텍스트 파일 내용 읽기 (로그 파일 등). bucket: 버킷 이름 key: 파일 키 max_bytes: 최대 읽기 바이트 (기본 10KB)
Inputs: key (required), bucket (required), max_bytes. Returns: result
sqs_list_queuesA
SQS 큐 목록과 메시지 수 조회. prefix: 큐 이름 접두사 필터 (선택)
Inputs: prefix. Returns: result
sqs_peek_messagesA
SQS 큐에서 메시지 미리보기 (삭제하지 않음). queue_name: 큐 이름 count: 조회할 메시지 수 (최대 10)
Inputs: queue_name (required), count. Returns: result
sqs_queue_detailA
SQS 큐 상세 정보 조회 (DLQ 연결, 설정 등). queue_name: 큐 이름
Inputs: queue_name (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Each tool targets a specific AWS resource and action, with clear prefixes per service. For example, cloudwatch_get_alarms and cloudwatch_get_metric are distinct, and even similar actions like list services for EC2, ECS, RDS are separated by service prefix.
Most tools follow a service_verb_noun pattern, but a few like rds_slow_queries and sqs_queue_detail omit the verb, and cloudwatch_search_logs uses 'search' instead of 'get' or 'list'. Overall, the pattern is mostly consistent and readable.
19 tools covering 7 AWS services is well-scoped for a monitoring server. Each service has 2-4 tools, providing essential listing and metric retrieval without unnecessary bloat.
The tool surface covers key monitoring operations: listing resources, getting metrics, querying logs, and reading files. The generic cloudwatch_get_metric tool fills gaps for unspecified services. Missing some advanced features like CloudWatch dashboards or detailed per-instance metrics, but adequate for common monitoring tasks.
Maintenance
Related MCP Connectors
Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
Monitoring + status pages set up by talking to Claude. Auto-detects 30+ SDKs and your URLs.
All-in-one monitoring for uptime, servers, incidents & status pages. Manage it all from AI chat.
Designs, prices, and deploys AWS/GCP cloud infrastructure from plain-English requirements.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to AWS infrastructure through AWS IAM Identity Center for secure, natural language management of cloud resources across multiple accounts. It enables users to execute AWS CLI commands, monitor resources, and run remote shell commands on EC2 instances via Systems Manager.1,185 npm15ISC
- AlicenseCqualityDmaintenanceA unified MCP server for AWS that enables natural language infrastructure management, cross-service resource discovery, and dependency mapping. It features 30 intelligent tools for cost optimization, incident investigation, and multi-account operations protected by a robust safety system.305MIT
- AlicenseBqualityDmaintenanceProvides a comprehensive suite of 76 tools for AWS cloud resource optimization, cost management, and infrastructure monitoring. It enables users to identify unused resources, analyze cost trends, right-size capacity, and maintain security compliance through natural language.76MIT
- AlicenseNot gradedqualityDmaintenanceEnables natural language analysis of AWS cloud costs, waste audits, and budget insights across multiple profiles and regions.MIT