Aws Mcp Setup

Configureert AWS MCP servers: gehoste no-auth docs endpoint of uvx proxy met credentials

Door zxkane · zxkane/aws-skills

Getest · Werkt ★ 8.4/10

Aws Mcp Setup — Configureert AWS MCP servers: gehoste no-auth docs endpoint of uvx proxy met credentials

Wat het doet

Stelt AWS MCP servers in voor een Claude Code project, waarbij gekozen wordt tussen het gehoste AWS Knowledge documentatie-eindpunt (geen authenticatie, geen lokale runtime) en de volledige AWS MCP proxy die via uvx met AWS credentials wordt uitgevoerd. Bevat een detectiestap die controleert op uvx en geldige AWS credentials voordat er gekozen wordt, de exacte mcpServers JSON voor elke optie, config-bestand prioriteit (.mcp.json, ~/.claude.json), en een troubleshooting tabel. Activeert wanneer u vraagt om AWS MCP te configureren, AWS documentatie zoektools toe te voegen, of een aws-mcp/awsdocs server die niet verbindt te debuggen.

Testrapport

De repo gekloond, geïnstalleerd in een tijdelijke HOME (SKILL.md landde op ~/.claude/skills/aws-mcp-setup/SKILL.md), de frontmatter geparset met PyYAML (naam + 357-tekens beschrijving + allowed-tools; geen gebundelde bestanden om op te lossen) en de drie externe referenties gecontroleerd: 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. Voor de output heb ik twee echte .mcp.json bestanden gebouwd. BASELINE (mijn eigen kennis, geschreven vóór het toepassen van de body): een stdio server `uvx awslabs.aws-documentation-mcp-server@latest`; ik startte deze en onderzocht deze via stdio — serverInfo awslabs.aws-documentation-mcp-server 1.29.0, tools read_documentation/read_sections/search_table/search_documentation/recommend, en het trok 42 pakketten bij de eerste run. SKILL artefact (volgens de detectiepoort van Stap 2: `which uvx` vond /opt/homebrew/bin/uvx maar `aws sts get-caller-identity` faalde met "command not found", dus de body routeert naar Optie B): {"awsdocs":{"type":"http","url":"https://knowledge-mcp.global.api.aws"}}; een live MCP initialize POST retourneerde serverInfo AWSKnowledgeMCP 1.0.0 en tools/list retourneerde aws___read_documentation, aws___search_documentation, aws___list_regions, aws___get_regional_availability, aws___retrieve_skill — overeenkomend met de toolnamen die SKILL.md's Stap 3 belooft. Concreet verschil: de configuratie van de skill heeft nul lokale runtime nodig en voegt list_regions/get_regional_availability/retrieve_skill toe, terwijl mijn baseline Python+uvx hard vereist; omgekeerd heeft baseline read_sections/search_table/recommend die de gehoste mist, dus het is een echte maar eenzijdige overwinning, vandaar 7 niet 9. Docs verliezen een punt omdat de IAM actienamen (aws-mcp:InvokeMCP/CallReadOnlyTool/CallReadWriteTool) en de `--metadata AWS_REGION=...` proxy vlag niet konden worden uitgeoefend zonder een AWS account. Beveiligingsscan schoon: geen curl|sh, geen base64, geen netwerk exfil, geen injection tekst; enige opmerking is het plaintext AWS_ACCESS_KEY_ID/SECRET env voorbeeld, dat de body vermeldt na de aanbevolen profielgebaseerde optie.

Getest op: 2026-07-21 · Claude Code 2.x (agent harness)

Installatie

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/

Commando's en voorbeeldprompts

  • /aws-mcp-setupConfigureert AWS MCP servers: gehoste no-auth docs endpoint of uvx proxy met credentials

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

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