Amazon Q Developer CLIでMCPを使うための設定
本記事では、2025年4月末にMCPのサポートを開始したAmazon Q Developer CLIと連携させ、AWS Documentation MCP Serverを利用してみます。
1. uvをインストールします。
curl -LsSf https://astral.sh/uv/install.sh | sh > curl -LsSf https://astral.sh/uv/install.sh | sh downloading uv 0.6.17 aarch64-apple-darwin no checksums to verify installing to /Users/username/.local/bin uv uvx everything's installed!
2. Pythonをインストールします。
uv python install 3.13
3. uvxからMCP サーバーを起動します。
uvx awslabs.aws-documentation-mcp-server@latest
4. MCP 設定を管理するJSONファイルを作成します。
mkdir -p .amazonq && vim .amazonq/mcp.json
5. configを以下に設定します。
{
"mcpServers": {
"awslabs.aws-documentation-mcp-server": {
"command": "/Users/ユーザー名/.local/bin/uvx",
"args": ["awslabs.aws-documentation-mcp-server@latest"],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR"
},
"disabled": false,
"autoApprove": []
}
}
}
6. 以下のコマンドを実行すると、MCPサーバが読み込まれたことが確認でき、Qのチャットが起動します。
q chat
To learn more about MCP safety, see https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-security.html
✓ awslabsaws_documentation_mcp_server loaded in 2.27 s
✓ 1 of 1 mcp servers initialized
Welcome to
█████╗ ███╗ ███╗ █████╗ ███████╗ ██████╗ ███╗ ██╗ ██████╗
██╔══██╗████╗ ████║██╔══██╗╚══███╔╝██╔═══██╗████╗ ██║ ██╔═══██╗
███████║██╔████╔██║███████║ ███╔╝ ██║ ██║██╔██╗ ██║ ██║ ██║
██╔══██║██║╚██╔╝██║██╔══██║ ███╔╝ ██║ ██║██║╚██╗██║ ██║▄▄ ██║
██║ ██║██║ ╚═╝ ██║██║ ██║███████╗╚██████╔╝██║ ╚████║ ╚██████╔╝
╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝╚══════╝ ╚═════╝ ╚═╝ ╚═══╝ ╚══▀▀═╝
╭───────────────────────── Did you know? ─────────────────────────╮
│ │
│ Q can use tools without asking for confirmation every time. │
│ Give /tools trust a try │
│ │
╰─────────────────────────────────────────────────────────────────╯
/help all commands • ctrl + j new lines • ctrl + k fuzzy search
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
