AWS MCP Servers (Official)

AWS MCP Servers (Official) とは？

AWS MCP Servers (Official) は awslabs/mcp リポジトリのことで、AI アシスタントに最新の AWS ドキュメント、ベストプラクティス、そして Lambda、EKS、DynamoDB、CloudWatch などのサービス向けツールを提供するオープンソースの AWS MCP server パッケージ群です。

Apache-2.0 ライセンスのこの monorepo には 50 以上の専用サーバーが含まれ、それぞれ uvx で個別にインストールします。リポジトリの README は、ホスト型の AWS MCP Server も案内しています。これは AWS が運用するマネージドのリモートエンドポイントで、AWS API へのアクセスとドキュメント検索を組み合わせたものです。現在 AWS は本番用途に Agent Toolkit for AWS（このマネージドサーバーを含む）を推奨しています。オープンソースのサーバーは引き続き動作し、コントリビューションも受け付けています。

AWS MCP Servers (Official) の使い方

AI クライアントを AWS に接続する方法は 2 つあります。ローカルのオープンソースサーバーを実行するか、マネージドの AWS MCP Server に接続するかです。

ローカルサーバー（awslabs/mcp）。 README に記載された前提条件：

1. Astral から uv をインストールします。
2. uv python install 3.10 で Python をインストールします。
3. 必要なサービスにアクセスできる AWS 認証情報を設定します。
4. MCP クライアントの設定にサーバーを追加します。

このページに表示されている設定は、Amazon Bedrock Knowledge Bases Retrieval サーバーを追加するものです：

{
  "mcpServers": {
    "awslabs.bedrock-kb-retrieval-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.bedrock-kb-retrieval-mcp-server@latest"],
      "env": {
        "AWS_PROFILE": "your-profile-name",
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

パッケージ名を別のサーバーに置き換えれば、ほかのサーバーも使えます。例：awslabs.aws-documentation-mcp-server、awslabs.aws-iac-mcp-server。各サーバーの README に、それぞれの引数と変数が記載されています。Windows では、README は uvx の代わりに uv tool run --from <package>@latest <package>.exe を使っています。Docker イメージはパブリックな AWS ECR レジストリ（public.ecr.aws/awslabs-mcp/...）で公開されています。

マネージド AWS MCP Server。 OAuth を使う場合、ローカルへのインストールは不要です。IAM ユーザーまたはロールに AWSMCPSignInOAuthAccessPolicy マネージドポリシーをアタッチし、クライアントを https://aws-mcp.us-east-1.api.aws/mcp などのリージョンエンドポイントに向けます。SigV4 認証の場合は、uvx mcp-proxy-for-aws-cli@latest で実行するローカルプロキシが AWS のドキュメントに記載されています。

Claude Code

ローカルサーバー（awslabs README より）：

claude mcp add aws-docs uvx awslabs.aws-documentation-mcp-server@latest
claude mcp add aws-iac uvx awslabs.aws-iac-mcp-server@latest
claude mcp add aws-pricing uvx awslabs.aws-pricing-mcp-server@latest

OAuth を使うマネージドサーバー（AWS ドキュメントより）：

claude mcp add aws-mcp https://aws-mcp.us-east-1.api.aws/mcp --transport http

プロジェクトのルートにある .mcp.json ファイルを使うこともできます。

Claude Desktop

マネージドサーバーを URL https://aws-mcp.us-east-1.api.aws/mcp?oauth=initialize のリモート MCP サーバーとして追加するか、上記のようなローカルの uvx 設定を Claude Desktop の設定ファイルに貼り付けます。

Cursor

JSON 設定を .cursor/mcp.json（プロジェクト単位）または ~/.cursor/mcp.json（グローバル）に置きます。README には Cursor 用のワンクリックインストールボタンがあります。マネージドサーバーの場合は、?oauth=initialize を付けたリモート URL を追加します。

VS Code

VS Code の設定または .vscode/mcp.json でサーバーを設定します。README には各サーバー用の VS Code ワンクリックインストールボタンがあります。

Codex

codex mcp add aws-mcp --url https://aws-mcp.us-east-1.api.aws/mcp?oauth=initialize

AWS MCP Servers (Official) の主な機能

• AWS 公式のソース：AWS Labs が Apache-2.0 で公開しています。
• 幅広いカバー範囲：ドキュメント、Infrastructure as Code（CDK、CloudFormation）、コンテナ（EKS、ECS、Finch）、サーバーレス、データベース（DynamoDB、Aurora、DocumentDB、Neptune、Redshift）、キャッシュ、メッセージング、コスト、ヘルスケア向けのサーバーがあります。
• 必要なものだけを選べる：各サーバーは独立した PyPI パッケージなので、プロジェクトに関係するツールだけを読み込めます。
• ローカルの stdio トランスポート：オープンソースのサーバーは stdio のみに対応します。SSE サポートは 2025 年 5 月 26 日に削除されました。
• マネージドの選択肢：ホスト型の AWS MCP Server は、IAM ベースの権限、CloudTrail の監査ログ、8 つのリージョンエンドポイントを提供します。
• クライアント別ガイド：Kiro、Cline、Cursor、Windsurf、VS Code、Claude Code、fx の設定手順があり、Windsurf では ~/.codeium/windsurf/mcp_config.json を使います。

AWS MCP Servers (Official) のツール

ツールはインストールするサーバーによって異なります。各 README からの例：

• AWS Documentation MCP Server：AWS ドキュメントの検索と閲覧のための read_documentation、search_documentation、read_sections、search_table、recommend。
• AWS API MCP Server：call_aws は検証済みの AWS CLI コマンドを実行し、suggest_aws_commands は自然言語のリクエストに対してコマンドを提案します。この README には、現在はマネージド AWS MCP Server に置き換えられたと記載されています。
• AWS Knowledge MCP Server（リモート）：search_documentation、read_documentation、list_regions、get_regional_availability、retrieve_skill。
• マネージド AWS MCP Server：aws___search_documentation や aws___retrieve_skill などのナレッジツールに加え、API ツールの aws___run_script（AWS API にアクセスできる Python をサンドボックスで実行）、aws___get_presigned_url、aws___get_tasks。

AWS MCP Servers (Official) のユースケース

• 最新の AWS 情報を得る：「Using the AWS Documentation MCP Server, explain how to configure Bedrock inline agents.」
• Infrastructure as Code：AWS IaC MCP Server を使って、現在のベストプラクティスに沿った CDK や CloudFormation を生成します。
• コスト見積もり：AWS Pricing MCP Server で「What would be the estimated monthly cost for this CDK project?」と尋ねます。
• 運用とトラブルシューティング：CloudWatch のメトリクス、アラーム、ログを分析したり、EKS や ECS のデプロイを管理したりします。
• データベース作業：RDS Data API 経由で Aurora PostgreSQL や MySQL にクエリを実行したり、DynamoDB のデータモデリングのガイダンスを得たりします。
• アカウント全体のタスク：マネージドサーバーの aws___run_script で、サービスをまたいでリソースを一覧し、その設定を確認します。

AWS MCP Servers (Official) と代替ツールの比較

• マネージド AWS MCP Server とローカルの awslabs サーバー：マネージドサーバーは OAuth ならローカルプロセスが不要で、呼び出しを CloudTrail に記録します。ローカルサーバーは手元のマシンで動作し、認証情報を手元に保ったまま、データベース、コンテナ、ヘルスケアなどの専用サービスをカバーします。AWS は、切り替える際にツールの重複を避けるため aws-api-mcp-server と aws-knowledge-mcp-server を削除するよう推奨しています。
• AWS MCP (RafalWilinski)：Claude Desktop 向けのコミュニティ製 Node.js サーバーで、ローカルの認証情報を使って AWS 環境を照会します。AWS とは無関係です。
• AWS MCP Server (alexei-led)：Docker コンテナ内で AWS CLI コマンドを実行するコミュニティ製サーバーです。

AWS MCP Servers (Official) のトラブルシューティング

• サーバーが起動しない、または引数不足と表示される：timeout 15s uv tool run <MCP Name> <args> のように手動で実行し、エラーを確認します。
• 起動が遅い：@latest サフィックスは起動のたびに PyPI を確認します。読み込み時間が気になる場合は外して、uv cache clean <tool> でキャッシュを管理します。
• Docker で env の値が反映されない："env" ブロックはコンテナに渡らないため、--env、--env-file、--volume で変数を渡します。
• マネージドサーバーで ExpiredTokenException が出る：認証情報を更新し（aws login または aws sso login）、クライアントを再起動します。
• OAuth サインイン後に 400 エラーになる：IAM プリンシパルに AWSMCPSignInOAuthAccessPolicy マネージドポリシーをアタッチします。