AWS MCPサーバー（DocumentationとKnowledge）をVS Codeで使えるようにしてみた

Last updated at 2025-10-20Posted at 2025-10-14

はじめに

この記事では、AWSのMCPサーバー（DocumentationとKnowledge）をVS Codeで利用できるようにする方法について紹介していきます。
途中、GitHub Copilotにも助けてもらいながら実装したので、その点も踏まえて読んでいただければと思います。

参考資料
AWS MCP Servers

前提

環境

VS Code Version : 1.103.2
WSL : 2.5.7.0
GitHub Copilot

準備

①uvのインストール
WSLのターミナル上で以下のコマンドを実行

curl -LsSf https://astral.sh/uv/install.sh | sh

②Python 3.10以上をインストール
uv同様、以下のコマンドを実行

uv python install

③VS CodeのAgentモードを有効化
VS Code画面の左下にあるアイコンから、Settingsをクリックし画像のようにチェックを入れる

事前準備に関する参考資料
AWS Documentation MCP Server

大まかな作業の流れ

AWS Documentation MCP サーバー、及びKnowledge MCP サーバーのどちらも作業の流れは以下の通りです。

mcp.jsonに入力
実行

AWS Documentation MCP サーバーの有効化

1. mcp.jsonに入力

WSLで、~/.vscode-server/data/User/mcp.json というファイルを探し、そこに以下の内容を記載をします。

{
  "servers": {
    "awslabs.aws-documentation-mcp-server": {
      "command": "/home/[user_name]/.local/bin/uvx",
      "args": ["awslabs.aws-documentation-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
# デフォルトは以下の記載
# {
#   "servers": {}
# }

以下のコマンドで出力された内容を、上記の"command"の項目に記載するのでもOK。
※uvはPythonパッケージ管理ツールです

which uvx

2. 実行

mcp.json への記載が完了すると、自動的に以下のような「Start」という文字が出てきます。そこにカーソルを合わせてクリックし、Running状態になれば準備完了です。
（Start状態）

（Running状態）

エラーが出た場合は、"command"横のパスの指定が合っているかを再確認してみて下さい

AWS Knowledge MCP サーバーの有効化

現在、正式に一般提供が開始となっているMCPサーバーです。AWS Knowledge MCP Server はドキュメントに限らず、FAQ、ベストプラクティス、トラブルシューティング記事など広範な知識を提供してくれます。

1. mcp.jsonに入力

Documentation MCP サーバーと同様に、Knowledge mcp サーバーの内容を追記します。

{
	"servers": {
	　# aws documentation mcp serverの設定
    　"awslabs.aws-documentation-mcp-server": {
        　"command": "/home/{username}/.local/bin/uvx",
        　"args": ["awslabs.aws-documentation-mcp-server@latest"],
        　"env": {
          　"FASTMCP_LOG_LEVEL": "ERROR"
        　},
        　"disabled": false,
        　"autoApprove": []
      　},
      # aws knowledge mcp serverの設定
    　"aws-knowledge-mcp-server": {
      　"url": "https://knowledge-mcp.global.api.aws"     
    }
  }
}

参考資料
AWS Knowledge MCP Server の一般提供開始

上記の記載方法で、TypeError: fetch failed というエラーが発生する場合は以下に修正して再度試してみてください(uvxがインストールされている必要があります)。

      "aws-knowledge-mcp-server": {
            "command": "uvx",
            "args": [
                "mcp-proxy",
                "--transport",
                "streamablehttp",
                "https://knowledge-mcp.global.api.aws"
            ]
      }