MCPサーバーのブラウザベースのテストツール"MCP Inspector"の使い方の備忘録です。

• はじめに
• MCP Inspectorの使い方
  • 前準備: ミニマムなMCPサーバーを用意する
  • MCP Inspectorを起動する
  • MCP Inspectorを使う
• おわりに
• 参考

はじめに

MCP Inspectorは、MCPが公式に提供しているブラウザベースのMCPサーバーテスト/デバッグツールです。

• GitHub - modelcontextprotocol/inspector: Visual testing tool for MCP servers

使い方をまとめます。

# 作業環境: macOS# バージョン$ python--versionPython3.11.9$ node--versionv20.19.0

The English translation of this post ishere.

MCP Inspectorの使い方

前準備: ミニマムなMCPサーバーを用意する

まず本記事で使うミニマムなMCPサーバーをPythonで用意します。パッケージマネージャーにはuvを使っていきます。

# Pythonプロジェクト作成uv init hellomcpcd hellomcp# 仮装環境作成uv venvsource .venv/bin/activate# MCPサーバーのPython SDKをインストールuv add"mcp[cli]"

main.pyには下記のようにミニマムなMCPサーバーを実装します。

from mcp.server.fastmcpimport FastMCPmcp = FastMCP("HelloMCP")@mcp.tool()defadd(a:int, b:int) ->int:"""Add two numbers"""return a + b@mcp.resource("greeting://{name}")defget_greeting(name:str) ->str:"""Get a personalized greeting"""return f"Hello, {name}!"@mcp.prompt()deftranslation_ja(txt:str) ->str:"""Translating to Japanese"""return f"Please translate this sentence into Japanese:\n\n{txt}"

Ref.GitHub - bioerrorlog/hellomcp: The minimal Python MCP server implementation with MCP Python SDK.

MCPが提供する3つの主要機能であるTools, Resources, Promptsをそれぞれ簡単に用意しました。

では、このMCPサーバーを対象にMCP Inspectorを使ってテスト実行していきます。

MCP Inspectorを起動する

MCP Inspectorの起動方法は2種類あります。

• MCP CLIで起動
• npx @modelcontextprotocol/inspectorで起動

uv add "mcp[cli]"のようにしてSDKをcliオプション付きでインストールした場合、MCP CLIが使えます。mcp devでMCP Inspectorを起動可能です。

$ mcp dev--help                                                                                           Usage: mcp dev[OPTIONS] FILE_SPEC                                                                                                                                                  Run a MCP server with the MCP Inspector.                                                                                                                                           ╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮│ *    file_spec      TEXT  Python file to run, optionally with :object suffix           ││[default: None]                                              ││[required]                                                   │╰────────────────────────────────────────────────────────────────────────────────────────╯╭─ Options ──────────────────────────────────────────────────────────────────────────────╮│--with-editable-e      DIRECTORY  Directory containing pyproject.toml to installin  ││                                     editable mode                                      ││[default: None]                                    ││--with                   TEXT       Additional packages to install                     ││--help                              Show this message andexit.                        │╰────────────────────────────────────────────────────────────────────────────────────────╯

# 実行例$ mcp dev main.pyStarting MCP inspector...⚙️ Proxy server listening on port6277🔍 MCP Inspector is up and running at http://127.0.0.1:6274 🚀

あるいは、npx @modelcontextprotocol/inspectorでMCP Inspectorを直接起動することも可能です。mcp devでも内部ではこのコマンドが使われています。

npx @modelcontextprotocol/inspector<MCPサーバー起動コマンド>

# 実行例$ npx @modelcontextprotocol/inspector mcp run main.pyStarting MCP inspector...⚙️ Proxy server listening on port6277🔍 MCP Inspector is up and running at http://127.0.0.1:6274 🚀

MCP Inspectorが起動したら、ブラウザからhttp://127.0.0.1:6274を開いてMCP Inspector画面に行きます。

MCP Inspectorを使う

では、http://127.0.0.1:6274からMCP Inspectorを使っていきます。

まずは、左タブの"▶︎Connect"ボタンをクリックし、MCPサーバーとMCP Inspectorを接続します。

ここの各上タブResources/Prompts/Toolsから、MCPサーバーが提供している機能のテスト実行が可能です。

それぞれList系の呼び出しでMCPサーバーが提供しているResources/Prompts/Toolsを一覧で取得し、それぞれの関数を引数を添えて呼び出しできます。

わざわざClaude DesktopなどのMCPクライアントに接続せずとも、MCPサーバーの機能をE2Eでピンポイントで試せるのは便利ですね。

おわりに

MCPサーバーのテストツール"MCP Inspector"の使い方の備忘録でした。

特にToolsは呼び出すかどうかがモデル次第/model-controlledなので、実際のMCPクライアントに接続してテストするのは面倒です。MCP InspectorでMCPサーバーのE2Eな振る舞いをチェックすれば、時間の節約になりそうですね。

以上、どなたかの参考になれば幸いです。

Follow @bioerrorlog

[関連記事]

www.bioerrorlog.work

www.bioerrorlog.work

参考

• Inspector - Model Context Protocol
• GitHub - modelcontextprotocol/inspector: Visual testing tool for MCP servers
• GitHub - modelcontextprotocol/python-sdk: The official Python SDK for Model Context Protocol servers and clients
• Debugging - Model Context Protocol
• Resources - Model Context Protocol
• GitHub - bioerrorlog/hellomcp: The minimal Python MCP server implementation with MCP Python SDK.