読み込み中

サーバーインスペクター

レッスン 534 分
読み込み中

MCPサーバーを構築する際には、完全なアプリケーションに接続せずに機能をテストする方法が必要です。Python MCP SDKには、ブラウザベースのインスペクターが組み込まれており、サーバーをリアルタイムでデバッグおよびテストできます。

インスペクターの起動

まず、Python環境がアクティブになっていることを確認してください(正確なコマンドについてはプロジェクトのREADMEを確認してください)。次に、以下のコマンドでインスペクターを実行します。

bash
mcp dev mcp_server.py

これにより開発サーバーが起動し、ブラウザでインスペクターにアクセスするためのローカルURL(通常はポート6277)が表示されます。

ターミナル出力: proxy server listening on port 6277 and MCP Inspector is up and running at http://127.0.0.1:6274.

インスペクターのインターフェースを使用する

ここに掲載されている画像と動画はインスペクターのバージョン1のものですが、mcp devは現在バージョン2を起動するようになっており、Node.js 22.19以降が必要です。バージョン2では、「Connect」をクリックする代わりにサーバーのカードにあるスイッチをオンにし、Toolsタブでは「List Tools」ボタンなしでツールが一覧表示され、「Run Tool」は「Execute Tool」という名前になっています。

接続前のMCPインスペクター。標準入出力トランスポート、「Connect」ボタン、ステータス「Disconnected」が表示されている。

MCPサーバーを起動するために「Connect」をクリックすると、以下のセクションを含むナビゲーションバーが表示されます。

  • Resources
  • Prompts
  • Tools
  • その他のサーバー機能

ツールのテスト

Toolsセクションは、デバッグ作業の大部分を費やすことになる場所です。「List Tools」をクリックすると、サーバーが提供するすべてのツールが表示されます。

「List Tools」をクリックした後のMCP Inspector Toolsタブ。read_doc_contentsとedit_documentが、それぞれの説明とともに一覧表示されている。

ツールを選択すると、右側のパネルにその詳細が表示され、テスト用の入力フィールドが提供されます。例えば、read_doc_contentsツールをテストするには:

  1. リストからツールを選択する
  2. ドキュメントID(「deposition.md」など)を入力する
  3. 「Run Tool」をクリックする
  4. 結果を確認し、成功と期待される出力を確認する

read_doc_contentsとedit_documentのツールを一覧表示しているMCP Inspector Toolsタブ。doc_idフィールドとRun Toolボタンがある。

ツールの連携テスト

複数のツールを順番にテストして、それらが正しく連携して動作することを確認できます。例えば、edit_documentツールを使用してコンテンツを編集した後:

doc_idがdeposition.md、old_strが「This」、new_strが「A report」のMCP Inspector edit_documentフォーム。Tool Result: Success。

同じドキュメントIDでread_doc_contentsツールを再度実行し、変更が適用されたことを確認します。

MCPインスペクター: 「deposition.md」に対するread_doc_contentsがTool Result Successを示し、「A report deposition covers」で始まるテキストを表示している。

開発ワークフロー

インスペクターは効率的な開発ループを生み出します。

  • MCPサーバーのコードに変更を加える
  • さまざまな入力で個々のツールをテストする
  • ツールの連携が期待どおりに動作することを確認する
  • 完全なアプリケーションのセットアップを必要とせずに問題をデバッグする

このブラウザベースのテスト環境は、MCPサーバー開発に不可欠です。問題を早期に発見し、Claudeやほかのアプリケーションと統合する前に機能を確認できるため、時間を節約できます。