Claude Desktop (Windows版) から AWS MCP Servers を使って AWS のドキュメントから情報を取得する

## はじめに

以前の記事では、Claude Desktop から Docker の MCP サーバーや Perplexity の MCP サーバーを使って情報を得たり GitHub に Issue を作成する方法を紹介しました。

https://qiita.com/revsystem/items/1c0a2a0aa8fd6b169c5d

https://qiita.com/revsystem/items/1e87004f603e46da1c67

今回は、[awslabs/mcp](https://github.com/awslabs/mcp) に公開されている AWS の MCP サーバーのなかから AWS Documentation MCP Server を使って AWS のドキュメントを取得・検索する方法を紹介します。macOS や Linux 環境では [awslabs/mcp](https://github.com/awslabs/mcp) リポジトリの README に記載されている方法でも可能ですが、Windows 環境では MCP サーバーの指定方法が異なります。本記事では Windows 環境での方法を紹介します。

## 参考情報

https://github.com/awslabs/mcp

## AWS MCP Servers とは

[awslabs/mcp](https://github.com/awslabs/mcp) の説明によると、AWS MCP Servers は、AWS のベストプラクティスをお客様の開発ワークフローに直接導入する MCP 専用サーバー群と書かれています。

> A suite of specialized MCP servers that bring AWS best practices directly to your development workflow.

AWS MCP Servers のひとつ、AWS Documentation MCP Server には以下の機能があります。この MCP サーバを Claude Desktop から使用すると、AWS のドキュメントを PDF や HTML でダウンロードして RAG を構築するといった手間を掛けずに AWS のドキュメントから情報を取得することができます。

- ドキュメントを読む: AWS のドキュメントページを取得し、マークダウン形式に変換する
- ドキュメントを検索する: 公式の検索 API を使用して AWS ドキュメントを検索する
- レコメンデーション: AWS ドキュメンテーションページの推奨コンテンツを取得する

## 前提条件

- Windows 11 を使用
- Claude Desktop 0.9.0 以降（この記事では Windows 版 0.9.0 を使用）

## Python 環境の構築

### uv のインストール

AWS Documentation MCP Server では uv による Python パッケージとプロジェクト管理ツールを使用します。[uv の公式ドキュメント](https://docs.astral.sh/uv/getting-started/installation/)に従って uv をインストールします。

```console
powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

```console
> uv --version
uv 0.6.11 (0632e24d1 2025-03-30)
```

### Python のインストール

uv をインストールしたら、Python 3.10 もしくはそれ以上のバージョンをインストールします。AWS Documentation MCP Server の公式ドキュメントには uv コマンドでインストールする手順が記載されていますが、他の手段でインストールした Python でも動作するかもしれません。

```console
uv python install 3.10
```

## Claude Desktop のセットアップ

### インストール

[Claude.ai 公式サイト](https://claude.ai/download)からインストーラーをダウンロードしてインストールします。

### MCP サーバーの設定

続いて、[AWS Documentation MCP Server の公式リポジトリ](https://github.com/awslabs/mcp/tree/main/src/aws-documentation-mcp-server)に従って AWS Documentation MCP Server をインストールします。

1. Claude Desktop を起動し、左上のハンバーガーメニューから「ファイル」→「設定」を選択
1. 設定ウィンドウから「開発者」を選択
1. 「構成を編集」をクリックしてエクスプローラーを開く
1. `claude_desktop_config.json` を編集（場所: `C:\Users\{ユーザー名}\AppData\Roaming\Claude\claude_desktop_config.json`）

![Claude Desktop の設定メニュー](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/61809/e627ec9b-1258-4c34-8428-a94743c6f7a7.png)

![Claude Desktop の開発者設定](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/61809/1ec5f39d-ca62-4f20-9d6b-62985e603e84.png)

`claude_desktop_config.json` に以下の設定を追加します。AWS Documentation MCP Server のドキュメントでは `args` に `awslabs.aws-documentation-mcp-server` のみを指定していますが、Windows 環境では異なることに注意してください。

```json:claude_desktop_config.json
{
  "mcpServers": {
    "awslabs.aws-documentation-mcp-server": {
      "command": "uvx",
      "args": [
          "--from",
          "awslabs-aws-documentation-mcp-server",
          "awslabs.aws-documentation-mcp-server.exe"
      ],
      "env": {
          "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

設定後、Claude Desktop を再起動します。メニューから「終了」を選択して閉じ、再度起動します。ウィンドウを閉じただけでは設定が反映されないため注意してください。

![Claude Desktop を終了する](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/61809/f3c1f976-86cf-4121-9e73-8797ea376688.png)

## 動作確認

Claude Desktop を起動すると、チャット画面にハンマーのアイコンが表示され、設定した権限に応じて利用可能な MCP ツールが表示されます。前回までの記事で GitHub の MCP サーバーと Perplexity の MCP サーバーを設定している場合、18 個のツールに今回のツールが加わり 21 個のツールが表示されます。

![ハンマーのアイコン](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/61809/74ac6ec2-871b-497f-83f0-7ff3c208aeaf.png)

ハンマーのアイコンをクリックすると、利用可能な MCP ツールが表示されます。その中に `read_documentation`、`search_documentation`、`recommend` が表示されていることを確認できます。

![利用可能な MCP ツール](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/61809/bae7cb9e-11b7-4314-9424-d837f0cfc6ca.png)

### 使用例: ドキュメントの検索

AWS Documentation MCP Server を使うには、プロンプトに「AWS に関するキーワード」と「ドキュメントから探して」のように AWS のドキュメントから検索を行うことを明示的に指定すると、AWS Documentation MCP Server が検索を行うようです。この MCP サーバーを使うかどうかは LLM が動的に判断しているので、この指定であっても MCP サーバーを使わない回答となる場合があります。

以下のような質問をしてみましょう：

> Ubuntu環境でコマンドラインでS3にファイルをアップロードする方法をドキュメントから探して。

![プロンプト実行](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/61809/cb881e0c-11c4-429a-ab03-92749f7625c1.png)

Claude は最初に AWS Documentation MCP Server の実行許可を求めます。

![実行許可](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/61809/fa0f6ca9-c0e1-4c5c-85b3-e080dfe19f68.png)

許可を与えると、AWS Documentation MCP Server が Ubuntu 環境でコマンドラインで S3 にファイルをアップロードする方法をドキュメントから探して、Claude に回答を返します。

![Ubuntu 環境でコマンドラインで S3 にファイルをアップロードする方法をドキュメントから探して。](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/61809/c8800def-14af-49fc-ac83-3cd48dd3a7d5.png)

## まとめ

Windows 環境では、`claude_desktop_config.json` に設定する MCP サーバーの定義が公式ドキュメントと異なることを紹介しました。Windows 環境で Cursor エディタや Cline の MCP 機能を使う場合もこの定義が利用できると思います。
Claude Desktop で AWS Documentation MCP Server を使うと、AWS ドキュメントを PDF や HTML でダウンロードして RAG を構築するといった手間を掛けずに AWS のドキュメントから情報を取得することができます。