aws-mcp-setup

AWS MCP サーバーの設定ガイド

概要

このガイドでは、AI エージェント向けに AWS MCP ツールを設定する方法を説明します。次の 2 つの方法があります。

方法	必要条件	機能
Full AWS MCP Server	Python 3.10+、uvx、AWS 認証情報	AWS API 呼び出しの実行 + ドキュメント検索
AWS Documentation MCP	なし	ドキュメント検索のみ

ステップ 1：既存の設定を確認する

設定する前に、次のいずれかの方法で AWS MCP ツールがすでに利用可能か確認してください。

方法 A：利用可能なツールを確認する（推奨）

エージェントで利用可能なツールの中から、次のパターンのツール名を探してください。

• mcp__aws-mcp__* または mcp__aws__* → Full AWS MCP Server が設定済み
• mcp__*awsdocs*__aws___* → AWS Documentation MCP が設定済み

確認方法：/mcp コマンドを実行して、アクティブな MCP サーバーをすべて一覧表示します。

方法 B：設定ファイルを確認する

エージェントのツールでは、階層型の設定が使用されます（優先順位：ローカル → プロジェクト → ユーザー → エンタープライズ）。

スコープ	ファイルの場所	用途
ローカル	.claude.json（プロジェクト内）	個人用／実験用
プロジェクト	.mcp.json（プロジェクトのルート）	チームで共有
ユーザー	~/.claude.json	複数プロジェクトでの個人用
エンタープライズ	システム管理ディレクトリ	組織全体

これらのファイルで、mcpServers に aws-mcp、aws、または awsdocs のキーが含まれているか確認してください。

# Check project config
cat .mcp.json 2>/dev/null | grep -E '"(aws-mcp|aws|awsdocs)"'

# Check user config
cat ~/.claude.json 2>/dev/null | grep -E '"(aws-mcp|aws|awsdocs)"'

# Or use Claude CLI
claude mcp list

AWS MCP がすでに設定されている場合、追加の設定は不要です。

ステップ 2：設定方法を選択する

自動検出

次のコマンドを実行して、どちらの方法を使用するか判断してください。

# Check for uvx (requires Python 3.10+)
which uvx || echo "uvx not available"

# Check for valid AWS credentials
aws sts get-caller-identity || echo "AWS credentials not configured"

方法 A：Full AWS MCP Server（推奨）

使用する場合：uvx が利用可能で、AWS 認証情報が有効な場合

前提条件：

• uv パッケージマネージャーを備えた Python 3.10+
• AWS 認証情報が設定済み（プロファイル、環境変数、または IAM ロール経由）

必要な IAM 権限：

{
  "Version": "2012-10-17",
  "Statement": [{
    "Effect": "Allow",
    "Action": [
      "aws-mcp:InvokeMCP",
      "aws-mcp:CallReadOnlyTool",
      "aws-mcp:CallReadWriteTool"
    ],
    "Resource": "*"
  }]
}

設定（MCP 設定に追加）：

{
  "mcpServers": {
    "aws-mcp": {
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://aws-mcp.us-east-1.api.aws/mcp",
        "--metadata", "AWS_REGION=us-west-2"
      ]
    }
  }
}

認証情報の設定方法：

1. AWS プロファイル（開発時に推奨）：

   "args": [
     "mcp-proxy-for-aws@latest",
     "https://aws-mcp.us-east-1.api.aws/mcp",
     "--profile", "my-profile",
     "--metadata", "AWS_REGION=us-west-2"
   ]
   

2. 環境変数：

   "env": {
     "AWS_ACCESS_KEY_ID": "...",
     "AWS_SECRET_ACCESS_KEY": "...",
     "AWS_REGION": "us-west-2"
   }
   

3. IAM ロール（EC2/ECS/Lambda 用）：追加の設定は不要です。インスタンスの認証情報が使用されます。

その他のオプション：

• --region <region>：AWS リージョンを上書きします
• --read-only：読み取り専用ツールに制限します
• --log-level <level>：ログレベルを設定します（debug、info、warning、error）

参考資料：https://github.com/aws/mcp-proxy-for-aws

方法 B：AWS Documentation MCP Server（認証不要）

使用する場合：

• Python/uvx 環境がない場合
• AWS 認証情報がない場合
• ドキュメント検索のみが必要な場合（API の実行は不要）

設定：

{
  "mcpServers": {
    "awsdocs": {
      "type": "http",
      "url": "https://knowledge-mcp.global.api.aws"
    }
  }
}

ステップ 3：確認

設定後、ツールが利用可能であることを確認してください。

Full AWS MCP の場合：

• 次のツールを探してください：mcp__aws-mcp__aws___search_documentation、mcp__aws-mcp__aws___call_aws

Documentation MCP の場合：

• 次のツールを探してください：mcp__awsdocs__aws___search_documentation、mcp__awsdocs__aws___read_documentation

トラブルシューティング

問題	原因	解決方法
uvx: command not found	uv がインストールされていない	pip install uv でインストールするか、方法 B を使用してください
AccessDenied エラー	IAM 権限が不足している	IAM ポリシーに aws-mcp:* 権限を追加してください
InvalidSignatureException	認証情報の問題	aws sts get-caller-identity を確認してください
ツールが表示されない	MCP が起動していない	設定を変更した後、エージェントを再起動してください