AWS Documentation

Servidor MCP de Documentación de AWS

Servidor del Protocolo de Contexto de Modelo (MCP) para la Documentación de AWS

Este servidor MCP proporciona herramientas para acceder a la documentación de AWS, buscar contenido y obtener recomendaciones.

Características

• Leer Documentación: Obtiene y convierte páginas de documentación de AWS a formato markdown
• Buscar Documentación: Busca en la documentación de AWS usando la API de búsqueda oficial (solo global)
• Leer Secciones: Obtiene secciones de una página de documentación de AWS y las convierte a formato markdown.
• Buscar en Tabla: Filtra y busca filas en tablas de documentación grandes (ej., cuotas de servicio, precios) sin leer la página completa (solo global)
• Recomendaciones: Obtiene recomendaciones de contenido para páginas de documentación de AWS (solo global)
• Obtener Lista de Servicios Disponibles: Obtiene una lista de los servicios de AWS disponibles en las regiones de China (solo China)

Prerrequisitos

Requisitos de Instalación

1. Instalar uv desde Astral o el README de GitHub
2. Instalar Python 3.10 o más reciente usando uv python install 3.10 (o una versión más reciente)

Instalación

Kiro	Cursor	VS Code

Configura el servidor MCP en la configuración de tu cliente MCP:

{
  "mcpServers": {
    "awslabs.aws-documentation-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.aws-documentation-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_DOCUMENTATION_PARTITION": "aws",
        "MCP_USER_AGENT": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Para la configuración de Kiro MCP, consulta la documentación de Kiro IDE o la documentación de Kiro CLI para más detalles.

Para configuración global, edita ~/.kiro/settings/mcp.json. Para configuración específica del proyecto, edita .kiro/settings/mcp.json en el directorio de tu proyecto.

Instalación en Windows

Para usuarios de Windows, el formato de configuración del servidor MCP es ligeramente diferente:

{
  "mcpServers": {
    "awslabs.aws-documentation-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.aws-documentation-mcp-server@latest",
        "awslabs.aws-documentation-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_DOCUMENTATION_PARTITION": "aws"
      }
    }
  }
}

Nota: Establece AWS_DOCUMENTATION_PARTITION a aws-cn para consultar la documentación de AWS China en lugar de la documentación global de AWS.

Redes Corporativas: Si estás detrás de un proxy corporativo o firewall que bloquea ciertas cadenas de User-Agent, establece MCP_USER_AGENT para que coincida con el User-Agent de tu navegador a una cadena permitida.

o docker después de un docker build -t mcp/aws-documentation . exitoso:

{
  "mcpServers": {
    "awslabs.aws-documentation-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--interactive",
        "--env",
        "FASTMCP_LOG_LEVEL=ERROR",
        "--env",
        "AWS_DOCUMENTATION_PARTITION=aws",
        "mcp/aws-documentation:latest"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Variables de Entorno

Variable	Descripción	Valor Predeterminado
FASTMCP_LOG_LEVEL	Nivel de registro (DEBUG, INFO, WARNING, ERROR, CRITICAL)	WARNING
AWS_DOCUMENTATION_PARTITION	Partición de AWS (aws o aws-cn)	aws
MCP_USER_AGENT	Cadena de User-Agent personalizada para solicitudes HTTP	Predeterminado basado en Chrome

Soporte para Redes Corporativas

Para entornos corporativos con servidores proxy o firewalls que bloquean ciertas cadenas de User-Agent:

{
  "env": {
    "MCP_USER_AGENT": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
  }
}

Uso Básico

Ejemplo:

• "busca documentación sobre las reglas de nomenclatura de buckets de S3. cita tus fuentes"
• "recomienda contenido para la página https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html"

Herramientas

read_documentation

Obtiene una página de documentación de AWS y la convierte a formato markdown.

read_documentation(url: str) -> str

search_documentation (solo global)

Busca en la documentación de AWS usando la API oficial de Búsqueda de Documentación de AWS.

search_documentation(ctx: Context, search_phrase: str, limit: int, product_types: Optional[List[str]], guide_types: Optional[List[str]]) -> SearchResponse

read_sections (solo global)

Obtiene secciones de una página de documentación de AWS y las convierte a formato markdown.

read_sections(url: str, section: list[str]) -> list[dict]

search_table (solo global)

Busca filas específicas en tablas de documentación grandes (ej., cuotas de servicio, tablas de precios, modelos compatibles). Más eficiente que read_sections para páginas con cientos de filas de tabla — devuelve las filas coincidentes como JSON estructurado en lugar de la tabla completa.

search_table(url: str, section_title: Optional[str], query: str, max_rows: int = 20) -> SearchTableResponse

recommend (solo global)

Obtiene recomendaciones de contenido para una página de documentación de AWS.

recommend(url: str) -> list[dict]

get_available_services (solo China)

Obtiene una lista de los servicios de AWS disponibles en las regiones de China.

get_available_services() -> str

Desarrollo

Para comenzar con el desarrollo en el Servidor MCP de Documentación de AWS, consulta primero la GUÍA_DE_DESARROLLO de awslabs/mcp. Todo lo que sigue a continuación es específico para el desarrollo del Servidor MCP de Documentación de AWS.

Ejecución de pruebas

Pruebas unitarias: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing Pruebas unitarias con pruebas de integración: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing --run-live