SkillProof tested Claude skills

Aws Mcp Setup

Configura servidores AWS MCP: endpoint de documentos alojado sin autenticación o proxy uvx con credenciales

Por zxkane · zxkane/aws-skills

Probado · Funciona ★ 8.4/10

Aws Mcp Setup — Configura servidores AWS MCP: endpoint de documentos alojado sin autenticación o proxy uvx con credenciales

Qué hace

Configura servidores AWS MCP para un proyecto de Claude Code, eligiendo entre el endpoint de documentación de AWS Knowledge alojado (sin autenticación, sin tiempo de ejecución local) y el proxy completo de AWS MCP ejecutado a través de uvx con credenciales de AWS. Incluye un paso de detección que verifica uvx y credenciales de AWS válidas antes de elegir, el JSON exacto de mcpServers para cada opción, la precedencia de archivos de configuración (.mcp.json, ~/.claude.json), y una tabla de resolución de problemas. Se activa cuando se solicita configurar AWS MCP, añadir herramientas de búsqueda de documentación de AWS, o depurar un servidor aws-mcp/awsdocs que no se conecta.

Informe de la prueba

Se clonó el repositorio, se instaló en un HOME temporal (SKILL.md se ubicó en ~/.claude/skills/aws-mcp-setup/SKILL.md), se analizó el frontmatter con PyYAML (nombre + 357 caracteres de descripción + allowed-tools; sin archivos empaquetados que resolver) y se verificaron sus tres referencias externas: github.com/aws/mcp-proxy-for-aws HTTP 200, pypi mcp-proxy-for-aws HTTP 200 (v1.6.4), knowledge-mcp.global.api.aws HTTP 200. Para la salida, construí dos archivos .mcp.json reales. LÍNEA BASE (mi propio conocimiento, escrito antes de aplicar el cuerpo): un servidor stdio `uvx awslabs.aws-documentation-mcp-server@latest`; lo inicié y lo probé a través de stdio — serverInfo awslabs.aws-documentation-mcp-server 1.29.0, herramientas read_documentation/read_sections/search_table/search_documentation/recommend, y extrajo 42 paquetes en la primera ejecución. Artefacto de HABILIDAD (siguiendo la puerta de detección del Paso 2: `which uvx` encontró /opt/homebrew/bin/uvx pero `aws sts get-caller-identity` falló con "command not found", por lo que el cuerpo se dirige a la Opción B): {"awsdocs":{"type":"http","url":"https://knowledge-mcp.global.api.aws"}}; un POST de inicialización de MCP en vivo devolvió serverInfo AWSKnowledgeMCP 1.0.0 y tools/list devolvió aws___read_documentation, aws___search_documentation, aws___list_regions, aws___get_regional_availability, aws___retrieve_skill — coincidiendo con los nombres de herramientas que SKILL.md promete en el Paso 3. Delta concreto: la configuración de la habilidad no necesita tiempo de ejecución local y añade list_regions/get_regional_availability/retrieve_skill, mientras que mi línea base requiere Python+uvx; por el contrario, la línea base tiene read_sections/search_table/recommend que el alojado carece, por lo que es una victoria real pero unilateral, de ahí 7 no 9. La documentación pierde un punto porque los nombres de acción de IAM (aws-mcp:InvokeMCP/CallReadOnlyTool/CallReadWriteTool) y el flag de proxy `--metadata AWS_REGION=...` no pudieron ejercitarse sin una cuenta de AWS. Escaneo de seguridad limpio: sin curl|sh, sin base64, sin exfiltración de red, sin texto de inyección; la única nota es el ejemplo de variable de entorno AWS_ACCESS_KEY_ID/SECRET en texto plano, que el cuerpo enumera después de la opción recomendada basada en perfil.

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/zxkane/aws-skills.git /tmp/aws-mcp-setup-src
mkdir -p ~/.claude/skills
cp -R /tmp/aws-mcp-setup-src/plugins/aws-common/skills/aws-mcp-setup ~/.claude/skills/aws-mcp-setup
# Skill is documentation-only (single SKILL.md, no scripts or bundled assets).
# Plugin-marketplace alternative: /plugin marketplace add zxkane/aws-skills then /plugin install aws-common@aws-skills
# No deps needed for the no-auth documentation option (remote HTTP MCP endpoint).
# The full AWS MCP option additionally needs: Python 3.10+ with uv/uvx, plus configured AWS credentials.
# Repo also ships aws-cdk-development, aws-sst-development, aws-cost-operations, aws-agentic-ai, aws-serverless-eda under plugins/*/skills/

Comandos y prompts de ejemplo

  • /aws-mcp-setupConfigura servidores AWS MCP: endpoint de documentos alojado sin autenticación o proxy uvx con credenciales

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • Set up the AWS documentation MCP server
  • Configure aws-mcp with my AWS credentials
  • Troubleshoot why my AWS MCP connection fails

Informe completo →