Aws Sage

🚀 AWS MCP

AWS MCP 是一個 模型上下文協議（MCP） 服務器，它能讓像 Claude 這樣的 AI 助手與你的 AWS 環境進行交互。藉助它，你可以在對話中通過自然語言查詢和管理 AWS 資源，可將其視為 Amazon Q 的優秀替代方案。

✨ 主要特性

• 支持使用自然語言查詢和修改 AWS 資源。
• 支持多個 AWS 配置文件。
• 支持多區域。
• 可使用你的 AWS 憑證在本地執行操作。

🚀 快速開始

工作流程

前提條件

• Python
• Claude 桌面應用
• 本地配置好 AWS 憑證（~/.aws/ 目錄）

📦 安裝指南

1. 克隆倉庫：

git clone https://github.com/yourusername/aws-mcp
cd aws-mcp

2. 安裝 Python MCP 服務器：

pip install -e .

💻 使用示例

作為命令行界面使用

AWS MCP 也可以作為命令行界面使用：

# 顯示可用命令
python -m aws_mcp --help

# 列出可用的 AWS 配置文件
python -m aws_mcp list-credentials

# 選擇一個 AWS 配置文件
python -m aws_mcp select-profile myprofile

# 運行 AWS 操作
python -m aws_mcp run-aws-code "list all S3 buckets"

# 使用漂亮的格式以獲得更易讀的輸出
python -m aws_mcp --format pretty list-credentials

⚠️ 重要提示：如有需要，請將 python 替換為你的 Python 可執行文件的路徑。

與 Claude 桌面應用配合使用

1. 打開 Claude 桌面應用，轉到“設置” -> “開發者” -> “編輯配置”。
2. 在你的 claude_desktop_config.json 中添加以下條目：

{
  "mcpServers": {
    "aws-mcp": {
      "command": "/path/to/your/python",
      "args": ["/path/to/your/aws-mcp/run_aws_mcp.py"]
    }
  }
}

⚠️ 重要提示：請將 /path/to/your/python 替換為你在終端中運行 which python 的結果。 ⚠️ 重要提示：請將 /path/to/your/aws-mcp/run_aws_mcp.py 替換為 run_aws_mcp.py 文件的實際路徑。 3. 重啟 Claude 桌面應用，確保沒有錯誤。 4. 可以先選擇一個 AWS 配置文件，或者直接通過提問來執行操作，例如：

• “列出可用的 AWS 配置文件”
• “列出我賬戶中的所有 EC2 實例”
• “顯示我的 S3 存儲桶及其大小”
• “美國東部 1 區部署了哪些 Lambda 函數？”
• “列出所有 ECS 集群及其服務”

故障排除

若要查看日誌，請執行以下命令：

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-aws-mcp.log
# 或者
tail -n 50 -f ~/Library/Logs/Claude/mcp.log

開發中的特性

• [ ] 支持多因素認證（MFA）
• [ ] 緩存 SSO 憑證，避免頻繁刷新

聯繫我們

如果你對 AWS MCP 有任何疑問、建議或想參與討論，請：

• 在 GitHub 上創建一個問題
• 發送電子郵件至：arun.sanna@outlook.com

有關如何為該項目做出貢獻的信息，請查看 CONTRIBUTING.md。

📚 詳細文檔

AWS 集成

AWS MCP 支持使用 boto3 動態執行 AWS 操作，它能夠：

1. 解析自然語言或類似代碼的請求，以確定 AWS 服務和操作。
2. 自動執行相應的 boto3 命令。
3. 儘可能將結果格式化為易讀的表格。
4. 優雅地處理錯誤。

支持的服務

解析器可以動態識別並處理通過 boto3 可用的所有 AWS 服務，包括：

• S3
• EC2
• Lambda
• IAM
• DynamoDB
• RDS
• CloudFormation
• CloudWatch
• SNS
• SQS
• KMS
• Secrets Manager
• SSM
• Route53
• CloudFront
• Elastic Beanstalk
• API Gateway
• ECS
• STS
• Cognito
• CodeBuild
• CodeCommit
• CodePipeline
• Organizations
• GuardDuty
• ……以及更多！