{"id":23317915,"url":"https://github.com/rafalwilinski/aws-mcp","last_synced_at":"2025-10-04T09:21:30.921Z","repository":{"id":268710511,"uuid":"905230258","full_name":"RafalWilinski/aws-mcp","owner":"RafalWilinski","description":"Talk with your AWS using Claude. Model Context Protocol (MCP) server for AWS. Better Amazon Q alternative.","archived":false,"fork":false,"pushed_at":"2025-03-04T14:53:47.000Z","size":2146,"stargazers_count":222,"open_issues_count":3,"forks_count":23,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-03-29T21:02:40.349Z","etag":null,"topics":["ai","amazon-q","aws","claude","llm","mcp"],"latest_commit_sha":null,"homepage":"https://rwilinski.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RafalWilinski.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-18T12:15:29.000Z","updated_at":"2025-03-29T16:25:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"b118b6fb-be97-4229-9509-a01b1c3b989f","html_url":"https://github.com/RafalWilinski/aws-mcp","commit_stats":null,"previous_names":["rafalwilinski/aws-mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RafalWilinski%2Faws-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RafalWilinski%2Faws-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RafalWilinski%2Faws-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RafalWilinski%2Faws-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RafalWilinski","download_url":"https://codeload.github.com/RafalWilinski/aws-mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247406084,"owners_count":20933803,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","amazon-q","aws","claude","llm","mcp"],"created_at":"2024-12-20T17:14:30.583Z","updated_at":"2025-10-04T09:21:25.870Z","avatar_url":"https://github.com/RafalWilinski.png","language":"TypeScript","funding_links":[],"categories":["Cloud \u0026 DevOps MCP Servers","Cloud Platforms"],"sub_categories":["How to Submit"],"readme":"# AWS MCP\n\nA [Model Context Protocol (MCP)](https://www.anthropic.com/news/model-context-protocol) server that enables AI assistants like Claude to interact with your AWS environment. This allows for natural language querying and management of your AWS resources during conversations. Think of better Amazon Q alternative.\n\n![AWS MCP](./images/aws-mcp-demo.png)\n\n## Features\n\n- 🔍 Query and modify AWS resources using natural language\n- ☁️ Support for multiple AWS profiles and SSO authentication\n- 🌐 Multi-region support\n- 🔐 Secure credential handling (no credentials are exposed to external services, your local credentials are used)\n- 🏃‍♂️ Local execution with your AWS credentials\n\n## Prerequisites\n\n- [Node.js](https://nodejs.org/)\n- [Claude Desktop](https://claude.ai/download)\n- AWS credentials configured locally (`~/.aws/` directory)\n\n## Installation\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/RafalWilinski/aws-mcp\ncd aws-mcp\n```\n\n2. Install dependencies:\n\n```bash\npnpm install\n# or\nnpm install\n```\n\n## Usage\n\n1. Open Claude desktop app and go to Settings -\u003e Developer -\u003e Edit Config\n\n![Claude Settings](./images/desktop_settings.png)\n\n2. Add the following entry to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"aws\": {\n      \"command\": \"npm\", // OR pnpm\n      \"args\": [\n        \"--silent\",\n        \"--prefix\",\n        \"/Users/\u003cYOUR USERNAME\u003e/aws-mcp\",\n        \"start\"\n      ]\n    }\n  }\n}\n```\n\nImportant: Replace `/Users/\u003cYOUR USERNAME\u003e/aws-mcp` with the actual path to your project directory.\n\n3. Restart Claude desktop app. You should see this:\n\n![Claude MCP Connection Status](./images/verify_installation.png)\n\n4. Start by selecting an AWS profile or jump to action by asking:\n   - \"List available AWS profiles\"\n   - \"List all EC2 instances in my account\"\n   - \"Show me S3 buckets with their sizes\"\n   - \"What Lambda functions are deployed in us-east-1?\"\n   - \"List all ECS clusters and their services\"\n\n## Using with `nvm`\n\nBuild from source first and add following config:\n\n```json\n{\n  \"mcpServers\": {\n    \"aws\": {\n      \"command\": \"/Users/\u003cUSERNAME\u003e/.nvm/versions/node/v20.10.0/bin/node\",\n      \"args\": [\n        \"\u003cWORKSPACE_PATH\u003e/aws-mcp/node_modules/tsx/dist/cli.mjs\",\n        \"\u003cWORKSPACE_PATH\u003e/aws-mcp/index.ts\",\n        \"--prefix\",\n        \"\u003cWORKSPACE_PATH\u003e/aws-mcp\",\n        \"start\"\n      ]\n    }\n  }\n}\n```\n\n## Troubleshooting\n\nTo see logs:\n\n```bash\ntail -n 50 -f ~/Library/Logs/Claude/mcp-server-aws.log\n# or\ntail -n 50 -f ~/Library/Logs/Claude/mcp.log\n```\n\n## Features in Development\n\n- [ ] MFA support\n- [ ] Cache SSO credentials to prevent from refreshing them too eagerly\n\n\u003ca href=\"https://glama.ai/mcp/servers/ta7kdy57us\"\u003e\u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/ta7kdy57us/badge\" alt=\"aws-mcp MCP server\" /\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafalwilinski%2Faws-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frafalwilinski%2Faws-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafalwilinski%2Faws-mcp/lists"}