SkillProof tested Claude skills

Aws Mcp Setup

Configure les serveurs AWS MCP : endpoint de documentation hébergé sans authentification ou proxy uvx avec identifiants

par zxkane · zxkane/aws-skills

Testé · Fonctionne ★ 8.4/10

Aws Mcp Setup — Configure les serveurs AWS MCP : endpoint de documentation hébergé sans authentification ou proxy uvx avec identifiants

Ce que fait

Configure les serveurs AWS MCP pour un projet Claude Code, en choisissant entre le point de terminaison de documentation AWS Knowledge hébergé (pas d'authentification, pas d'exécution locale) et le proxy AWS MCP complet exécuté via uvx avec des identifiants AWS. Inclut une étape de détection qui vérifie uvx et les identifiants AWS valides avant de choisir, le JSON mcpServers exact pour chaque option, la précédence des fichiers de configuration (.mcp.json, ~/.claude.json), et un tableau de dépannage. Se déclenche lorsque vous demandez de configurer AWS MCP, d'ajouter des outils de recherche de documentation AWS, ou de déboguer un serveur aws-mcp/awsdocs qui ne se connecte pas.

Rapport de test

Cloné le dépôt, installé dans un HOME temporaire (SKILL.md a atterri à ~/.claude/skills/aws-mcp-setup/SKILL.md), analysé le frontmatter avec PyYAML (nom + description de 357 caractères + allowed-tools ; aucun fichier groupé à résoudre) et vérifié ponctuellement ses trois références externes : 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. Pour la sortie, j'ai construit deux fichiers .mcp.json réels. BASELINE (ma propre connaissance, écrite avant d'appliquer le corps) : un serveur stdio `uvx awslabs.aws-documentation-mcp-server@latest` ; je l'ai lancé et sondé via stdio — serverInfo awslabs.aws-documentation-mcp-server 1.29.0, outils read_documentation/read_sections/search_table/search_documentation/recommend, et il a tiré 42 paquets lors de la première exécution. Artefact SKILL (suivant la porte de détection de l'étape 2 : `which uvx` a trouvé /opt/homebrew/bin/uvx mais `aws sts get-caller-identity` a échoué avec « command not found », donc le corps se dirige vers l'option B) : {"awsdocs":{"type":"http","url":"https://knowledge-mcp.global.api.aws"}} ; un POST d'initialisation MCP en direct a renvoyé serverInfo AWSKnowledgeMCP 1.0.0 et tools/list a renvoyé aws___read_documentation, aws___search_documentation, aws___list_regions, aws___get_regional_availability, aws___retrieve_skill — correspondant aux noms d'outils promis par l'étape 3 de SKILL.md. Delta concret : la configuration de la compétence ne nécessite aucune exécution locale et ajoute list_regions/get_regional_availability/retrieve_skill, tandis que ma base de référence exige Python+uvx ; inversement, la base de référence a read_sections/search_table/recommend que la version hébergée n'a pas, c'est donc une victoire réelle mais unilatérale, d'où 7 et non 9. La documentation perd un point car les noms d'action IAM (aws-mcp:InvokeMCP/CallReadOnlyTool/CallReadWriteTool) et le drapeau de proxy `--metadata AWS_REGION=...` n'ont pas pu être exercés sans compte AWS. Scan de sécurité propre : pas de curl|sh, pas de base64, pas d'exfiltration réseau, pas de texte d'injection ; seule note est l'exemple d'environnement AWS_ACCESS_KEY_ID/SECRET en texte clair, que le corps liste après l'option basée sur le profil recommandée.

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

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/

Commandes et exemples de prompts

  • /aws-mcp-setupConfigure les serveurs AWS MCP : endpoint de documentation hébergé sans authentification ou proxy uvx avec identifiants

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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

Rapport complet →