SkillProof tested Claude skills

Aws Mcp Setup

Configura server AWS MCP: endpoint di documenti ospitati senza autenticazione o proxy uvx con credenziali

di zxkane · zxkane/aws-skills

Promosso ★ 8.4/10

Aws Mcp Setup — Configura server AWS MCP: endpoint di documenti ospitati senza autenticazione o proxy uvx con credenziali

Cosa fa

Configura i server AWS MCP per un progetto Claude Code, scegliendo tra l'endpoint di documentazione AWS Knowledge ospitato (nessuna autenticazione, nessun runtime locale) e il proxy AWS MCP completo eseguito tramite uvx con credenziali AWS. Include un passaggio di rilevamento che verifica uvx e credenziali AWS valide prima di scegliere, il JSON mcpServers esatto per ogni opzione, la precedenza dei file di configurazione (.mcp.json, ~/.claude.json) e una tabella di risoluzione dei problemi. Si attiva quando si chiede di configurare AWS MCP, aggiungere strumenti di ricerca della documentazione AWS o eseguire il debug di un server aws-mcp/awsdocs che non si connette.

Rapporto di test

Clonato il repository, installato in una HOME temporanea (SKILL.md è stato posizionato in ~/.claude/skills/aws-mcp-setup/SKILL.md), analizzato il frontmatter con PyYAML (nome + descrizione di 357 caratteri + allowed-tools; nessun file in bundle da risolvere) e controllato a campione i suoi tre riferimenti esterni: 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. Per l'output ho costruito due file .mcp.json reali. BASELINE (la mia conoscenza, scritta prima di applicare il corpo): un server stdio `uvx awslabs.aws-documentation-mcp-server@latest`; l'ho avviato e testato tramite stdio — serverInfo awslabs.aws-documentation-mcp-server 1.29.0, tools read_documentation/read_sections/search_table/search_documentation/recommend, e ha scaricato 42 pacchetti alla prima esecuzione. Artefatto SKILL (seguendo il gate di rilevamento del Passaggio 2: `which uvx` ha trovato /opt/homebrew/bin/uvx ma `aws sts get-caller-identity` è fallito con "command not found", quindi il corpo instrada all'Opzione B): {"awsdocs":{"type":"http","url":"https://knowledge-mcp.global.api.aws"}}; un POST di inizializzazione MCP live ha restituito serverInfo AWSKnowledgeMCP 1.0.0 e tools/list ha restituito aws___read_documentation, aws___search_documentation, aws___list_regions, aws___get_regional_availability, aws___retrieve_skill — corrispondente ai nomi degli strumenti che il Passaggio 3 di SKILL.md promette. Delta concreto: la configurazione della skill non necessita di runtime locale e aggiunge list_regions/get_regional_availability/retrieve_skill, mentre la mia baseline richiede Python+uvx; al contrario la baseline ha read_sections/search_table/recommend che quella ospitata manca, quindi è una vittoria reale ma unilaterale, quindi 7 non 9. I documenti perdono un punto perché i nomi delle azioni IAM (aws-mcp:InvokeMCP/CallReadOnlyTool/CallReadWriteTool) e il flag proxy `--metadata AWS_REGION=...` non potevano essere esercitati senza un account AWS. Scansione di sicurezza pulita: nessun curl|sh, nessun base64, nessun exfil di rete, nessun testo di iniezione; l'unica nota è l'esempio di ambiente AWS_ACCESS_KEY_ID/SECRET in testo semplice, che il corpo elenca dopo l'opzione basata su profilo consigliata.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

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/

Comandi e prompt di esempio

  • /aws-mcp-setupConfigura server AWS MCP: endpoint di documenti ospitati senza autenticazione o proxy uvx con credenziali

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →