もしHermesエージェントのMCPサーバーがDockerで起動しなくても、MCPの設定が完全に間違っているとは考えないでください。コンテナ内のnpx、npm、nodeコマンドのパスを確認することに集中してください。 Hermes Agent v0.15.1は2026年5月29日にDockerのMCP生コマンド解析の問題を修正しました。Nodeツールチェーンが存在してもコンテナが起動しないように、これらのコマンドを/usr/local/binに解析します。
この質問は通常こんな感じです
ローカルでnpx実行しますが、HermesエージェントはDockerバックエンドのMCPサーバーを呼び出すときに正しく表示されません。 時にはログにMCP接続の失敗、空のツールリスト、あるいは「静かな故障」だけが表示されることもあります。 このような状況は、APIキーの誤りやMCPマニフェストの書き方として誤解されやすいです。実際には、コンテナ内のプロセスが取得するPATHにノードの位置が含まれていないだけかもしれません。
調査する際はまず三つのことをしてください
- まず、Hermesエージェントをv0.15.1にアップグレードして、v0.15.0で既知のDocker PATHの問題を回避してください。
- コンテナに入り、
which node、which npm、which npxを実行して実際のパスを確認します。 - 今のところアップグレードできない場合は、MCP設定のbareコマンドをabsolute path(絶対パス)に変更してください。例えば
/usr/local/bin/npx。
絶対パスに切り替えた後に始まるなら、問題はPATHにあるということです。MCPパラメータを大きく変え続けるのはやめましょう。 アップグレード後は、より一般的な素命令に復元できますが、特にチーム共有設定の場合はロール可能なバックアップを保持しておく必要があります。
他にPATHに該当しない状況は?
npxは見つかってもMCPが失敗する場合、3つの問題が考えられます:インタラクティブ入力が必要だがコンテナがインタラクトできない; MCPサーバーで必要とされる環境変数はコンテナに渡されませんでした。 この画像にはランタイム依存性がありません。 判断の推奨順番は「コマンドが見つかるか、依存関係を開始可能、認証情報が完成し、ヘルメスは接続できるか?」です。 こうすることでトラブルシューティングが最も速く、誤って設定を削除してしまう可能性も低いです。
