Amazon Q Developer CLI でMCPサーバ起動に失敗したのでトラブルシュートしてもらった

はじめに

普段あまり使わない環境でトラブルに直面したのでトラブルシュートしてもらいました。

結論から申し上げますと下記の様に（例）
uvx awslabs.core-mcp-server@latest
を実行した際のエラーメッセージを確認し対処なのですが
q chat 内で切り分けまで実施してくれ、素晴らしいなと思いましたので共有です。

目次

• 実行環境
• トラブルシュート

実行環境

Amazon Q Developer CLIをインストール後
https://www.skyarch.net/blog/amazon-q-developer-cli-agent/

MCP Serverを公式ドキュメントに沿ってインストールを実施した環境
https://github.com/awslabs/mcp?tab=readme-ov-file#installation-and-setup

トラブルシュート

mcp.jsonを記載後MCPServer(s)が起動しない状況

% q chat ⚠ 0 of 4 mcp servers initialized. Servers still loading: - awslabsaws_diagram_mcp_server - awslabscdk_mcp_server - awslabscore_mcp_server - awslabsaws_documentation_mcp_server ⢠⣶⣶⣦⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣤⣶⣿⣿⣿⣶⣦⡀⠀ ⠀⠀⠀⣾⡿⢻⣿⡆⠀⠀⠀⢀⣄⡄⢀⣠⣤⣤⡀⢀⣠⣤⣤⡀⠀⠀⢀⣠⣤⣤⣤⣄⠀⠀⢀⣤⣤⣤⣤⣤⣤⡀⠀⠀⣀⣤⣤⣤⣀⠀⠀⠀⢠⣤⡀⣀⣤⣤⣄⡀⠀⠀⠀⠀⠀⠀⢠⣿⣿⠋⠀⠀⠀⠙⣿⣿⡆ ⠀⠀⣼⣿⠇⠀⣿⣿⡄⠀⠀⢸⣿⣿⠛⠉⠻⣿⣿⠛⠉⠛⣿⣿⠀⠀⠘⠛⠉⠉⠻⣿⣧⠀⠈⠛⠛⠛⣻⣿⡿⠀⢀⣾⣿⠛⠉⠻⣿⣷⡀⠀⢸⣿⡟⠛⠉⢻⣿⣷⠀⠀⠀⠀⠀⠀⣼⣿⡏⠀⠀⠀⠀⠀⢸⣿⣿ ⠀⢰⣿⣿⣤⣤⣼⣿⣷⠀⠀⢸⣿⣿⠀⠀⠀⣿⣿⠀⠀⠀⣿⣿⠀⠀⢀⣴⣶⣶⣶⣿⣿⠀⠀⠀⣠⣾⡿⠋⠀⠀⢸⣿⣿⠀⠀⠀⣿⣿⡇⠀⢸⣿⡇⠀⠀⢸⣿⣿⠀⠀⠀⠀⠀⠀⢹⣿⣇⠀⠀⠀⠀⠀⢸⣿⡿ ⢀⣿⣿⠋⠉⠉⠉⢻⣿⣇⠀⢸⣿⣿⠀⠀⠀⣿⣿⠀⠀⠀⣿⣿⠀⠀⣿⣿⡀⠀⣠⣿⣿⠀⢀⣴⣿⣋⣀⣀⣀⡀⠘⣿⣿⣄⣀⣠⣿⣿⠃⠀⢸⣿⡇⠀⠀⢸⣿⣿⠀⠀⠀⠀⠀⠀⠈⢿⣿⣦⣀⣀⣀⣴⣿⡿⠃ ⠚⠛⠋⠀⠀⠀⠀⠘⠛⠛⠀⠘⠛⠛⠀⠀⠀⠛⠛⠀⠀⠀⠛⠛⠀⠀⠙⠻⠿⠟⠋⠛⠛⠀⠘⠛⠛⠛⠛⠛⠛⠃⠀⠈⠛⠿⠿⠿⠛⠁⠀⠀⠘⠛⠃⠀⠀⠘⠛⠛⠀⠀⠀⠀⠀⠀⠀⠀⠙⠛⠿⢿⣿⣿⣋⠀⠀ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠛⠿⢿⡧

1 2 3 4 5 6 7 8 9 10 11 12 13 14

% q chat 0 of 4 mcp servers initialized. Servers still loading: - awslabsaws_diagram_mcp_server - awslabscdk_mcp_server - awslabscore_mcp_server - awslabsaws_documentation_mcp_server        ⢠⣶⣶⣦⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣤⣶⣿⣿⣿⣶⣦⡀⠀ ⠀⠀⠀⣾⡿⢻⣿⡆⠀⠀⠀⢀⣄⡄⢀⣠⣤⣤⡀⢀⣠⣤⣤⡀⠀⠀⢀⣠⣤⣤⣤⣄⠀⠀⢀⣤⣤⣤⣤⣤⣤⡀⠀⠀⣀⣤⣤⣤⣀⠀⠀⠀⢠⣤⡀⣀⣤⣤⣄⡀⠀⠀⠀⠀⠀⠀⢠⣿⣿⠋⠀⠀⠀⠙⣿⣿⡆ ⠀⠀⣼⣿⠇⠀⣿⣿⡄⠀⠀⢸⣿⣿⠛⠉⠻⣿⣿⠛⠉⠛⣿⣿⠀⠀⠘⠛⠉⠉⠻⣿⣧⠀⠈⠛⠛⠛⣻⣿⡿⠀⢀⣾⣿⠛⠉⠻⣿⣷⡀⠀⢸⣿⡟⠛⠉⢻⣿⣷⠀⠀⠀⠀⠀⠀⣼⣿⡏⠀⠀⠀⠀⠀⢸⣿⣿ ⠀⢰⣿⣿⣤⣤⣼⣿⣷⠀⠀⢸⣿⣿⠀⠀⠀⣿⣿⠀⠀⠀⣿⣿⠀⠀⢀⣴⣶⣶⣶⣿⣿⠀⠀⠀⣠⣾⡿⠋⠀⠀⢸⣿⣿⠀⠀⠀⣿⣿⡇⠀⢸⣿⡇⠀⠀⢸⣿⣿⠀⠀⠀⠀⠀⠀⢹⣿⣇⠀⠀⠀⠀⠀⢸⣿⡿ ⢀⣿⣿⠋⠉⠉⠉⢻⣿⣇⠀⢸⣿⣿⠀⠀⠀⣿⣿⠀⠀⠀⣿⣿⠀⠀⣿⣿⡀⠀⣠⣿⣿⠀⢀⣴⣿⣋⣀⣀⣀⡀⠘⣿⣿⣄⣀⣠⣿⣿⠃⠀⢸⣿⡇⠀⠀⢸⣿⣿⠀⠀⠀⠀⠀⠀⠈⢿⣿⣦⣀⣀⣀⣴⣿⡿⠃ ⠚⠛⠋⠀⠀⠀⠀⠘⠛⠛⠀⠘⠛⠛⠀⠀⠀⠛⠛⠀⠀⠀⠛⠛⠀⠀⠙⠻⠿⠟⠋⠛⠛⠀⠘⠛⠛⠛⠛⠛⠛⠃⠀⠈⠛⠿⠿⠿⠛⠁⠀⠀⠘⠛⠃⠀⠀⠘⠛⠛⠀⠀⠀⠀⠀⠀⠀⠀⠙⠛⠿⢿⣿⣿⣋⠀⠀ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠛⠿⢿⡧

/tools コマンドで確認しても読み込まれていない事を確認

切り分けを依頼

!> MCPサーバが起動しない原因を調べて MCPサーバーが起動しない原因を調査するために、いくつかの確認を行いましょう。まず、現在の環境やログを確認してみます。 🛠️ Using tool: execute_bash (trusted) ⋮ ● I will run the following shell command: ps aux | grep mcp ⋮ ↳ Purpose: MCPサーバープロセスの確認 kouzu 18772 0.0 0.0 408637584 1792 s001 S+ 11:19AM 0:00.00 grep mcp kouzu 18770 0.0 0.0 408639136 2176 s001 S+ 11:19AM 0:00.00 bash -c ps aux | grep mcp ⋮ ● Completed in 0.164s MCPサーバーのプロセスが見つかりません。次に、MCPサーバーの設定ファイルやログを確認してみましょう。 (省略) ● I will run the following shell command: which uvx || echo "uvx not found" ⋮ ↳ Purpose: uvxコマンドの確認 (省略) ● I will run the following shell command: uvx --version ⋮ ↳ Purpose: uvxのバージョン確認(省略) 🛠️ Using tool: execute_bash (trusted) ⋮ ● I will run the following shell command: cd ~/.aws/amazonq && /Users/kouzu/.local/bin/uvx awslabs.core-mcp-server@latest ⋮ ↳ Purpose: MCPサーバーの手動起動テスト Installed 36 packages in 259ms /Users/kouzu/.cache/uv/archive-v0/JewLEDP8M1jXJV5L1NeGr/bin/awslabs.core-mcp-server: line 2: /Users/kouzu/.aws/amazonq/python: No such file or directory ⋮ ● Completed in 0.884s 🛠️ Using tool: execute_bash (trusted) ⋮ ● I will run the following shell command: which python3 ⋮ ↳ Purpose: Pythonの確認 /opt/homebrew/bin/python3 ⋮ ● Completed in 0.22s ● Completed in 0.15s MCPサーバーが起動しない原因が特定できました。以下の問題があります： 1. 主な問題点: • MCPサーバーが/Users/kouzu/.aws/amazonq/pythonを探していますが、このパスにPythonがインストールされていない 2. 解決策: 1. **Pythonパスの問題を解決**: MCPサーバーが特定のパスでPythonを探しているようです。以下のいずれかの方法で解決できます： • シンボリックリンクを作成する: mkdir -p ~/.aws/amazonq/ ln -s /opt/homebrew/bin/python3 ~/.aws/amazonq/python • または、MCPサーバーの設定を更新して正しいPythonパスを指定する 3. その他の確認点: • uvxは正常にインストールされており、バージョンは0.7.12です • MCPサーバーの設定ファイル(mcp.json)は存在し、複数のMCPサーバーが設定されています これらの問題を解決すれば、MCPサーバーが正常に起動するはずです。特にrealpathコマンドのインストールとPythonパスの設定が重要です。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66

!> MCPサーバが起動しない原因を調べて MCPサーバーが起動しない原因を調査するために、いくつかの確認を行いましょう。まず、現在の環境やログを確認してみます。     Using tool: execute_bash (trusted) ⋮ ● I will run the following shell command: ps aux | grep mcp ⋮ ↳ Purpose: MCPサーバープロセスの確認 kouzu            18772   0.0  0.0 408637584   1792 s001  S+   11:19AM   0:00.00 grep mcp kouzu            18770   0.0  0.0 408639136   2176 s001  S+   11:19AM   0:00.00 bash -c ps aux | grep mcp   ⋮ ● Completed in 0.164s MCPサーバーのプロセスが見つかりません。次に、MCPサーバーの設定ファイルやログを確認してみましょう。 (省略)   ● I will run the following shell command: which uvx || echo "uvx not found" ⋮ ↳ Purpose: uvxコマンドの確認 (省略) ● I will run the following shell command: uvx --version ⋮ ↳ Purpose: uvxのバージョン確認(省略)     Using tool: execute_bash (trusted) ⋮ ● I will run the following shell command: cd ~/.aws/amazonq && /Users/kouzu/.local/bin/uvx awslabs.core-mcp-server@latest ⋮ ↳ Purpose: MCPサーバーの手動起動テスト   Installed 36 packages in 259ms /Users/kouzu/.cache/uv/archive-v0/JewLEDP8M1jXJV5L1NeGr/bin/awslabs.core-mcp-server: line 2: /Users/kouzu/.aws/amazonq/python: No such file or directory ⋮ ● Completed in 0.884s     Using tool: execute_bash (trusted) ⋮ ● I will run the following shell command: which python3 ⋮ ↳ Purpose: Pythonの確認   /opt/homebrew/bin/python3 ⋮ ● Completed in 0.22s   ● Completed in 0.15s MCPサーバーが起動しない原因が特定できました。以下の問題があります：   1. 主な問題点:    • MCPサーバーが/Users/kouzu/.aws/amazonq/pythonを探していますが、このパスにPythonがインストールされていない   2. 解決策:    1. **Pythonパスの問題を解決**:      MCPサーバーが特定のパスでPythonを探しているようです。以下のいずれかの方法で解決できます：         • シンボリックリンクを作成する:         mkdir -p ~/.aws/amazonq/         ln -s /opt/homebrew/bin/python3 ~/.aws/amazonq/python         • または、MCPサーバーの設定を更新して正しいPythonパスを指定する   3. その他の確認点:    • uvxは正常にインストールされており、バージョンは0.7.12です    • MCPサーバーの設定ファイル(mcp.json)は存在し、複数のMCPサーバーが設定されています   これらの問題を解決すれば、MCPサーバーが正常に起動するはずです。特にrealpathコマンドのインストールとPythonパスの設定が重要です。

というわけで、プロセス状態確認から始まり、各コマンドの実行結果/バージョン確認、パス確認も行い、切り分けを行ってくれた上で、解決策も提示してくれました。
今回は取り急ぎ提示された通りにシンボリックリンク作成で無事MCP Server(s)が起動してくれました。

心なしかAmazon Q テキストアートが輝いて見える...ありがとう！