https://www.bioerrorlog.work/entry/how-to-use-mcp-inspector

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

はじめに

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

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

使い方をまとめます。

# 作業環境: macOS
# バージョン
$ python --version
Python 3.11.9
$ node --version
v20.19.0

The English translation of this post is here.

MCP Inspectorの使い方

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

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

# Pythonプロジェクト作成
uv init hellomcp
cd hellomcp

# 仮装環境作成
uv venv
source .venv/bin/activate

# MCPサーバーのPython SDKをインストール
uv add "mcp[cli]"

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

from mcp.server.fastmcp import FastMCP


mcp = FastMCP("HelloMCP")


@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b


@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"


@mcp.prompt()
def translation_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 install in  │
│                                     editable mode                                      │
│                                     [default: None]                                    │
│ --with                   TEXT       Additional packages to install                     │
│ --help                              Show this message and exit.                        │
╰────────────────────────────────────────────────────────────────────────────────────────╯

# 実行例
$ mcp dev main.py
Starting MCP inspector...
⚙️ Proxy server listening on port 6277
🔍 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.py
Starting MCP inspector...
⚙️ Proxy server listening on port 6277
🔍 MCP Inspector is up and running at http://127.0.0.1:6274 🚀

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