mcp-uiが外部ツールを呼び出せない場合の解決策
mcp-uiが外部ツールの起動に失敗する場合、設定エラー、サービスが起動していない、ツールの定義に問題があるなどの原因が考えられます。以下に具体的な解決方法を示す:
- MCPサービスが正常に機能していることを確認するMCPバックエンド・サービスが開始されていることを確認してください。
npm run mcp:server
)、報告されたエラーがないかターミナルをチェックする。 - 検証ツールの設定検査
mcp_server.js
ツール名、パラメーター、説明が正しく定義されていることを確認する。name: "browser"
. - API接続のテストチャットボックスに簡単なコマンド(例:"Open Google Search AI")を入力し、ツール呼び出しログが返されるかどうかを確認する。応答がない場合は、ポートの競合(デフォルト3001)かもしれないので、以下を変更してください。
.env
正鵠を得るMCP_SERVER_PORT
. - 依存関係のチェック走る
npm ls
すべての依存関係(たとえば@mcp/core
)がインストールされ、見つからない場合は再実行できる。npm install
.
問題が解決しない場合は、以下の回避策をお試しください:
- すべてのサービス(フロントエンド、バックエンド、Electron)を再起動します。
- プロジェクトのGitHub Issuesページをチェックし、同様の問題を検索してください。
- 開発者ツール(F12)の「ネットワーク」タブで、APIリクエストが正しく送信されているか確認してください。
この答えは記事から得たものである。mcp-ui: MCPプロトコルに基づいたクリーンなAIチャットインターフェースについて