![[アップデート] Amazon Q Developer CLI の MCP サーバー構成コマンドが追加されていたので試してみた](https://images.ctfassets.net/ct0aopd36mqt/wp-thumbnail-5dd35cec6954843cd98f8fe0f8bf3afe/08b840eb79b1e885b48a9fad3081ce0a/amazon-q)
[アップデート] Amazon Q Developer CLI の MCP サーバー構成コマンドが追加されていたので試してみた
2025.05.23いわさです。
Amazon Q Developer CLI では Model Context Protocol (MCP) がサポートされており、様々な MCP ツールを追加することが出来ます。
通常はグローバルあるいはワークスペースに MCP 構成ファイルを作成することで有効化が出来るのですが、今朝 Amazon Q Developer CLI のドキュメントを眺めていると Q Developer CLI の MCP 構成を管理するコマンドが追加されていることを確認しました。
公式ドキュメント上は以下のページの最後の部分に少しだけ記載されています。
本日は実際にこのコマンドを使い、従来の設定方法と何が変わるのかを確認してみました。
qchat mcp コマンド
まずはコマンドのヘルプから確認してみましょう。qchat mcpが今回の対象コマンドです。
% qchat mcp
Model Context Protocol (MCP)
Usage: qchat mcp [OPTIONS] <COMMAND>
Commands:
add Add or replace a configured server
remove Remove a server from the MCP configuration
list List configured servers
import Import a server configuration from another file
status Get the status of a configured server
help Print this message or the help of the given subcommand(s)
Options:
-v, --verbose... Increase logging verbosity
-h, --help Print help
このあたりは公式ドキュメントでも確認出来ますね。
add/removeでツールの追加/削除を行い、listで現在の構成一覧を確認できるようです。
Q Developer CLI の MCP サーバー構成はグローバルとワークスペースと存在するのですが、そのあたりの設定はどうするのでしょうか。
ということで個別の設定をみてみます。
まずは確認しやすそうなlistを試してみます。
% qchat mcp list
📄 workspace:
/Users/iwasa.takahito/work/hoge0523qdev/.amazonq/mcp.json
(empty)
🌍 global:
/Users/iwasa.takahito/.aws/amazonq/mcp.json
(empty)
なるほど。グローバルとワークスペースどちらも管理できるみたいですね。
今はまだ MCP サーバーの設定をしていないのでどちらもemptyですね。
ではサーバー構成を追加してみます。
まずはaddコマンドのヘルプを確認してみましょう。
Usage: qchat mcp add [OPTIONS] --name <NAME> --command <COMMAND>
Options:
--name <NAME> Name for the server
--command <COMMAND> The command used to launch the server
--scope <SCOPE> Where to add the server to [possible values: workspace, global]
--env <ENV> Environment variables to use when launching the server
--timeout <TIMEOUT> Server launch timeout, in milliseconds
--force Overwrite an existing server with the same name
-v, --verbose... Increase logging verbosity
-h, --help Print help
なるほど。nameとcommandで指定が出来るみたいです。
scopeを指定することでグローバルかワークスペースか、どちらなのかを設定できる感じですね。
注意点として、色々と確認してみたのですがどうやらargsオプションの指定は出来ないみたいです。
ほぼ使うのでそんなはずがない気はするのですが...設定方法ご存知の方いらっしゃったら教えてください。
一応次のように追加は出来ました。
% qchat mcp add --name hogemcp1 --command "uvx awslabs.aws-documentation-mcp-server@latest"
To learn more about MCP safety, see https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-security.html
✓ Added MCP server 'hogemcp1' to 📄 workspace
listを確認してみると、追加された MCP ツールの一覧と構成ファイルのパスを確認することが出来ます。
% qchat mcp list
📄 workspace:
/Users/iwasa.takahito/work/hoge0523qdev/.amazonq/mcp.json
• hogemcp1 uvx awslabs.aws-documentation-mcp-server@latest
🌍 global:
/Users/iwasa.takahito/.aws/amazonq/mcp.json
(empty)
addコマンドを使うことで構成ファイルに対象 MCP サーバーの構成が追加されていることを確認しました。
{
"mcpServers": {
"hogemcp1": {
"command": "uvx awslabs.aws-documentation-mcp-server@latest",
"args": [],
"env": {},
"timeout": 120000
}
}
}
addコマンドで追加できないオプションを指定したい場合など、より柔軟に設定したい場合は構成ファイルのインポートが出来るのでこちらを使うほうが使いやすいかもしれません。
ローカルで次のように AWS Documentation MCP Server 用の構成ファイルを用意しておきます。
{
"mcpServers": {
"awslabs.aws-documentation-mcp-server": {
"command": "uvx",
"args": [
"awslabs.aws-documentation-mcp-server@latest"
],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR"
},
"disabled": false,
"autoApprove": [
"read_documentation"
]
}
}
}
これをimportコマンドで指定してみました。
% qchat mcp import --file hoge.json
To learn more about MCP safety, see https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-security.html
✓ Imported 1 MCP server(s) into 📄 workspace
% qchat mcp list
📄 workspace:
/Users/iwasa.takahito/work/hoge0523qdev/.amazonq/mcp.json
• awslabs.aws-documentation-mcp-server uvx
🌍 global:
/Users/iwasa.takahito/.aws/amazonq/mcp.json
(empty)
% cat .amazonq/mcp.json
{
"mcpServers": {
"awslabs.aws-documentation-mcp-server": {
"command": "uvx",
"args": [
"awslabs.aws-documentation-mcp-server@latest"
],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR"
},
"timeout": 120000
}
}
}
今度は綺麗に取り込みがされていますね。良さそうです。
デフォルトだとワークスペースに取り込まれますが、スコープを指定することも可能です。次のように指定した場合はグローバルへ取り込まれます。
% qchat mcp import --file hoge.json global
📁 Created MCP config in '/Users/iwasa.takahito/.aws/amazonq/mcp.json'
To learn more about MCP safety, see https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-security.html
✓ Imported 1 MCP server(s) into 🌍 global
% qchat mcp list
📄 workspace:
/Users/iwasa.takahito/work/hoge0523qdev/.amazonq/mcp.json
• awslabs.aws-documentation-mcp-server uvx
🌍 global:
/Users/iwasa.takahito/.aws/amazonq/mcp.json
• awslabs.aws-documentation-mcp-server uvx
さいごに
本日は Amazon Q Developer CLI の MCP サーバー構成コマンドが追加されていたので試してみました。
まず、listはかなり使いやすいと思いました。いま現在の環境で MCP サーバーの構成何が設定されているのか確認する際に使えそうです。
構成の追加ですがaddはなかなか使い方が難しいと思いました。一方で Q Developer CLI 以外も MCP サーバーの構成内容はほぼ同じなのでimportで取り込み管理するのが使いやすそうです。
従来どおり構成ファイルを直接編集しても全然問題ないので、無理にこのコマンドに寄せる必要は無さそうですが、listくらいは覚えておくと便利になりそうです。
