Aws Sage

🚀 AWS MCP

Model Context Protocol (MCP)サーバーで、ClaudeのようなAIアシスタントがAWS環境と対話できるようになります。これにより、会話中に自然言語でAWSリソースをクエリし、管理することが可能です。Amazon Qのより良い代替手段と考えてください。

✨ 主な機能

• 自然言語を使用してAWSリソースをクエリおよび変更する
• 複数のAWSプロファイルをサポートする
• マルチリージョンをサポートする
• ローカルでAWS資格情報を使用して実行する

🚀 クイックスタート

ワークフロー

前提条件

• Python
• Claude Desktop
• ローカルに構成された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 Desktopでの使用

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プロファイルを選択するか、アクションを開始します：

• "List available AWS profiles"
• "List all EC2 instances in my account"
• "Show me S3 buckets with their sizes"
• "What Lambda functions are deployed in us-east-1?"
• "List all ECS clusters and their services"

トラブルシューティング

ログを表示するには：

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
• ...その他多数！