MCPクライアントを使う

Qt Creator はモデルコンテキストプロトコル(MCP)をサポートしており、AIアシスタントがデバッグ、ビルド、プロジェクト管理のためにMCPを制御することができます。

MCPクライアントを使用するには、MCPクライアントをインストールし、Qt Creator MCPサーバエクステンションを有効にしてMCPサーバを起動します。

MCPサーバーステータスの表示

Qt Creator は、Qt Creator MCPサーバー拡張機能を有効にすると、MCPサーバーを起動します。サーバは127.0.0.1 で実行され、ポート3001 で接続を受け付けます。セキュリティ上の理由から、リモート・コンピュータで実行することはできません。

MCPサーバーのステータスを表示するには、Tools >MCP Server >About MCP Server にアクセスしてください。

サーバーが起動しない場合は、General Messages にポートが使用中である旨の警告が表示されているかどうかを確認してください。

他のプロセスがそのポートにバインドされていないことを確認します。例えば、Linuxの場合、Terminal にlsof -i :3001 と入力します。

3001 以外のポートを使用するには、Qt Creator が起動する前に、MCP_SERVER_PORT 環境変数を設定してポートを構成します。

単純なMCPクライアントのセットアップ

POST要求を送信し、SSE応答を読み取ることができる任意のHTTPクライアントを使用できます。このセクションでは、pip を使用して、単純な MCP クライアントをインストールする方法と、それを構成する方法について説明します。

単純な MCP クライアントをインストールして構成するには、以下の手順に従います：

1. Terminal にアクセスし、次のように入力します：

   pip install simple-mcp-client

2. qtcreator MCPサーバを指すように、simple_mcp_client\config.json 構成ファイルを変更します：

   "mcpServers": {
     "qtcreator": {
       "enable": false,
       "type": "sse",
       "url": "http://127.0.0.1:3001/sse",
       "command": null,
       "args": [],
       "env": {}
     }
   }

config.json ファイルは以下の場所にあります：

• Linuxの場合：~/.config/simple_mcp_client/
• Windowsの場合：C:\Users\<username>\AppData\Roaming\simple_mcp_client

Qt Creator ツールの実行

MCP クライアントからQt Creator ツールを実行するには、クライアントを起動し、Qt Creator MCP サーバに接続します。

MCPクライアントを起動し、Qt Creator ツールのリストを表示します：

1. Terminal にアクセスし、次のように入力します：

   python -m simple_mcp_client.main

2. Mini MCP Client Network Hub に次のように入力します：

   connect qtcreator

3. ツールのリストを表示するには、次のように入力します：

   tools qtcreator

   

4. ツールを実行するには

   execute qtcreator <tool-name>

   例えば

   execute qtcreator list_sessions

SSE接続が失敗する場合は、MCPクライアントがCORS（cross-origin resource sharing）をサポートしていることを確認してください。CORSはHTTPヘッダーに基づくメカニズムで、サーバーが他のドメイン、スキーム、 ポートのリソースをロードすることを許可します。

Windowsの場合、ファイアウォールがlocalhost へのインバウンド接続をブロックしている可能性があります。Qt Creator の実行ファイルがローカル・トラフィックを受け入れられることを確認してください。

Qt Creator が終了してもデバッグ・セッションが停止しない場合は、Debug モードでデバッグを手動で停止するか、MCP_QUIT_TIMEOUT 環境変数を 60 秒に設定してタイムアウトを増やすことができます。

ツールの概要

以下の表は、サーバーが登録するQt Creator ツールをまとめたものである。各ツールはJSON-RPCメソッドで、名前、人間が読めるタイトル、説明、入出力JSONスキーマ、およびツールが読み取り専用かどうかを示すフラグを持つ。

静的ツールに加えて、プラグインは最も一般的なQt Creator アクションをトリガーするための動的ツールを登録します：

• run_project Run アクションをトリガーします。
• build Build アクションを起動します。
• clean_project Clean アクションを起動します。
• debug Debug アクションをトリガーします。

動的ツールは空のparams オブジェクトを受け取り、{ "success": true|false } を返します。

ツールの追加

MCP Serverエクステンションは、Core::ActionManager 、表に示す名前のツールを作成します。この実装では、McpServer::runOnGuiThread() を介して、UIスレッドでQAction::trigger() を呼び出します。

したがって、McpServer::initializeToolsForCommands() に小さなラッパーを追加することで、ActionManager を介して公開されるその他のコマンドをMCPツールに変換できます。