MCP服务器调试工具

AIエージェント (Claude Desktop)
    ↓ MCP Protocol
本MCPサーバー (mcp_inspector_mcp) ← このプロジェクト
    ↓ MCP Protocol
対象MCPサーバー (fundamental_analysis, filesystem, etc.)

# PowerShellで実行
# https://rustup.rs/ から rustup-init.exe をダウンロードして実行

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

rustc --version  # rust 1.70.0 以上
cargo --version  # cargo 1.70.0 以上

git clone https://github.com/yourusername/mcp_inspector_mcp.git
cd mcp_inspector_mcp

cargo build --release

# ヘルプメッセージの表示
./target/release/mcp_inspector_mcp --help

# デバッグモードでの起動確認（すぐにCtrl+Cで終了してOK）
RUST_LOG=info ./target/release/mcp_inspector_mcp

# Rustツールチェインを最新に更新
rustup update

# 依存関係のクリーンビルド
cargo clean
cargo build --release

# cratesのミラーサイトを使用（中国など）
# .cargo/config.toml に以下を追加
[source.crates-io]
replace-with = 'mirror'

[source.mirror]
registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"

# 実行可能ファイルのディレクトリに移動
cd target/release

# 初回起動（設定ファイルが自動生成される）
./mcp_inspector_mcp

target/release/.inspector/
└── config.json  # デフォルト設定

{
  "servers": [],
  "logging": {
    "backend": "memory",
    "db_path": "./data/logs.db",
    "max_logs": 10000
  }
}

{
  "servers": [
    {
      "name": "my_first_server",
      "transport": "stdio",
      "command": "C:\\path\\to\\your\\mcp_server.exe",
      "args": [],
      "env": {}
    }
  ],
  "logging": {
    "backend": "memory",
    "db_path": "./data/logs.db",
    "max_logs": 10000
  }
}

{
  "servers": [
    {
      "name": "my_first_server",
      "transport": "stdio",
      "command": "/path/to/your/mcp_server",
      "args": [],
      "env": {}
    }
  ],
  "logging": {
    "backend": "memory",
    "db_path": "./data/logs.db",
    "max_logs": 10000
  }
}

{
  "mcpServers": {
    "mcp-inspector": {
      "command": "C:\\Users\\YourName\\mcp_inspector_mcp\\target\\release\\mcp_inspector_mcp.exe"
    }
  }
}

{
  "mcpServers": {
    "mcp-inspector": {
      "command": "/Users/yourname/mcp_inspector_mcp/target/release/mcp_inspector_mcp"
    }
  }
}

mcp-inspectorに登録されているサーバーの一覧を教えてください

{
  "name": "config_list_servers",
  "arguments": {}
}

"my_first_server"が提供しているツールの一覧を取得してください

{
  "name": "tools_list",
  "arguments": {
    "server": "my_first_server"
  }
}

"my_first_server"のヘルスチェックを実行してください

{
  "name": "health_check",
  "arguments": {
    "server": "my_first_server"
  }
}

{カレントディレクトリ}/.inspector/config.json

{
  "servers": [
    {サーバー設定1},
    {サーバー設定2},
    ...
  ],
  "logging": {
    ログ設定
  },
  "execution_config": {
    実行設定（オプション）
  }
}

{
  "servers": [
    {
      "name": "fundamental_analysis",
      "transport": "stdio",
      "command": "C:/projects/fa/target/release/fa.exe",
      "args": [],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    },
    {
      "name": "technical_analysis",
      "transport": "stdio",
      "command": "C:/projects/ta/target/release/ta.exe",
      "args": ["--verbose"],
      "env": {}
    },
    {
      "name": "filesystem",
      "transport": "stdio",
      "command": "/usr/local/bin/mcp-filesystem",
      "args": [],
      "env": {}
    }
  ],
  "logging": {
    "backend": "memory",
    "db_path": "./data/logs.db",
    "max_logs": 10000
  }
}

{
  "logging": {
    "backend": "memory",
    "max_logs": 10000
  }
}

{
  "logging": {
    "backend": "persistent",
    "db_path": "./data/logs.db",
    "max_logs": 10000
  }
}

# Windowsの場合
mkdir data

# macOS/Linuxの場合
mkdir -p ./data

{
  "servers": [...],
  "logging": {...},
  "execution_config": {
    "tool_timeout_ms": 60000,
    "connection_timeout_ms": 10000,
    "retry_count": 1,
    "auto_retry_on_timeout": false
  }
}

{
  "execution_config": {
    "tool_timeout_ms": 120000,  // 2分
    "retry_count": 2,
    "auto_retry_on_timeout": true
  }
}

"my_new_server"という名前で"C:/path/to/server.exe"をMCP Inspectorに登録してください

{
  "name": "config_add_server",
  "arguments": {
    "name": "my_new_server",
    "transport": "stdio",
    "command": "C:/path/to/server.exe",
    "args": [],
    "env": {}
  }
}

"my_new_server"をMCP Inspectorから削除してください

{
  "name": "config_remove_server",
  "arguments": {
    "name": "my_new_server"
  }
}

MCP Inspectorに登録されているサーバーを教えてください

{
  "name": "config_list_servers",
  "arguments": {}
}

"fundamental_analysis"サーバーが提供しているツールの一覧を取得してください

{
  "name": "tools_list",
  "arguments": {
    "server": "fundamental_analysis"
  }
}

{
  "server": "fundamental_analysis",
  "tools": [
    {
      "name": "get_financial_ratios",
      "description": "企業の財務比率を取得します",
      "input_schema": {
        "type": "object",
        "properties": {
          "ticker": {
            "type": "string",
            "description": "ティッカーシンボル（例: AAPL）"
          }
        },
        "required": ["ticker"]
      }
    },
    {
      "name": "calculate_dcf",
      "description": "DCF法による企業価値評価",
      "input_schema": {...}
    }
  ]
}

"fundamental_analysis"サーバーの"get_financial_ratios"ツールを使って、
AAPLの財務比率を取得してください

{
  "name": "tools_call",
  "arguments": {
    "server": "fundamental_analysis",
    "tool_name": "get_financial_ratios",
    "arguments": {
      "ticker": "AAPL"
    }
  }
}

{
  "server": "fundamental_analysis",
  "tool_name": "get_financial_ratios",
  "result": {
    "ticker": "AAPL",
    "ratios": {
      "pe_ratio": 28.5,
      "pb_ratio": 42.1,
      "debt_to_equity": 1.73,
      "roe": 0.147
    }
  }
}

"fundamental_analysis"サーバーが提供しているリソースの一覧を教えてください

{
  "name": "resources_list",
  "arguments": {
    "server": "fundamental_analysis"
  }
}

{
  "server": "fundamental_analysis",
  "resources": [
    {
      "uri": "file:///data/sp500_list.csv",
      "name": "S&P 500 List",
      "description": "S&P 500構成銘柄のリスト",
      "mime_type": "text/csv"
    },
    {
      "uri": "file:///data/financial_reports/AAPL_2024Q4.json",
      "name": "AAPL 2024 Q4 Report",
      "description": "Appleの2024年Q4決算レポート",
      "mime_type": "application/json"
    }
  ]
}

"fundamental_analysis"サーバーの"file:///data/sp500_list.csv"リソースを読み込んでください

{
  "name": "resources_read",
  "arguments": {
    "server": "fundamental_analysis",
    "uri": "file:///data/sp500_list.csv"
  }
}

{
  "server": "fundamental_analysis",
  "uri": "file:///data/sp500_list.csv",
  "contents": [
    {
      "uri": "file:///data/sp500_list.csv",
      "mime_type": "text/csv",
      "text": "Symbol,Name,Sector\nAAPL,Apple Inc.,Technology\nMSFT,Microsoft Corporation,Technology\n...",
      "blob": null
    }
  ]
}

"fundamental_analysis"サーバーが提供しているプロンプトテンプレートの一覧を取得してください

{
  "name": "prompts_list",
  "arguments": {
    "server": "fundamental_analysis"
  }
}

{
  "server": "fundamental_analysis",
  "prompts": [
    {
      "name": "analyze_company",
      "description": "企業の財務分析を行うプロンプト",
      "arguments": [
        {
          "name": "ticker",
          "description": "ティッカーシンボル",
          "required": true
        },
        {
          "name": "analysis_type",
          "description": "分析タイプ（fundamental/technical）",
          "required": false
        }
      ]
    }
  ]
}

"fundamental_analysis"サーバーの詳細な設定情報を取得してください。
サーバーのバージョン、サポートしている機能、プロトコルバージョンを確認したいです。

{
  "name": "server_inspect",
  "arguments": {
    "server": "fundamental_analysis"
  }
}

{
  "server_name": "fundamental_analysis",
  "implementation": {
    "name": "fundamental-analysis-server",
    "title": "Financial Analysis Server",
    "version": "1.2.3",
    "website_url": "https://example.com"
  },
  "capabilities": {
    "logging": true,
    "experimental": false,
    "completions": false,
    "prompts": {
      "supported": true,
      "list_changed": false
    },
    "resources": {
      "supported": true,
      "subscribe": false,
      "list_changed": false
    },
    "tools": {
      "supported": true,
      "list_changed": false
    }
  },
  "connection_status": "connected",
  "protocol_version": "2024-11-05",
  "instructions": null
}

"fundamental_analysis"サーバーのヘルスチェックを実行して、
レスポンスタイムとエラー率を教えてください

{
  "name": "health_check",
  "arguments": {
    "server": "fundamental_analysis"
  }
}

{
  "server_name": "fundamental_analysis",
  "status": "healthy",
  "response_time_ms": 45,
  "last_check": "2025-11-18T10:30:00Z",
  "error_count": 0,
  "error_rate": 0.0,
  "details": null
}

"fundamental_analysis"サーバーから送信されたエラーレベル以上のログメッセージを
最新50件取得してください

{
  "name": "logging_messages",
  "arguments": {
    "server": "fundamental_analysis",
    "level": "error",
    "limit": 50
  }
}

{
  "server_name": "fundamental_analysis",
  "messages": [
    {
      "timestamp": "2025-11-18T10:25:30Z",
      "server_name": "fundamental_analysis",
      "level": "error",
      "logger": "app.api_client",
      "message": "Failed to fetch data from external API: timeout"
    },
    {
      "timestamp": "2025-11-18T10:22:15Z",
      "server_name": "fundamental_analysis",
      "level": "error",
      "logger": "app.database",
      "message": "Database connection lost, retrying..."
    }
  ],
  "total_count": 2
}

["fundamental_analysis", "technical_analysis", "filesystem"]の3つのサーバーの
ツール一覧を一度に取得してください

{
  "name": "list_tools_batch",
  "arguments": {
    "servers": ["fundamental_analysis", "technical_analysis", "filesystem"]
  }
}

{
  "results": [
    {
      "server": "fundamental_analysis",
      "tools": [...]
    },
    {
      "server": "technical_analysis",
      "tools": [...]
    },
    {
      "server": "filesystem",
      "tools": [...]
    }
  ],
  "errors": []
}

"fundamental_analysis"サーバーのSamplingリクエストログを最新10件取得してください

{
  "name": "sampling_logs",
  "arguments": {
    "server": "fundamental_analysis",
    "limit": 10,
    "status": "all"
  }
}

{
  "server": "fundamental_analysis",
  "tools": [
    {
      "name": "tool_name",
      "description": "Tool description",
      "input_schema": {
        "type": "object",
        "properties": {...},
        "required": [...]
      }
    }
  ]
}

"fundamental_analysis"サーバーのツール一覧を取得してください

{
  "server": "fundamental_analysis",
  "tool_name": "calculate_rsi",
  "result": {
    "symbol": "AAPL",
    "rsi": 65.3,
    "status": "overbought"
  }
}

"fundamental_analysis"サーバーの"calculate_rsi"ツールを
引数 {"symbol": "AAPL", "period": 14} で実行してください

{
  "server": "fundamental_analysis",
  "resources": [
    {
      "uri": "file:///path/to/resource",
      "name": "Resource Name",
      "description": "Resource description",
      "mime_type": "text/plain"
    }
  ]
}

"fundamental_analysis"サーバーのリソース一覧を取得してください

{
  "server": "fundamental_analysis",
  "uri": "file:///data/sp500.csv",
  "contents": [
    {
      "uri": "file:///data/sp500.csv",
      "mime_type": "text/csv",
      "text": "Symbol,Name,Sector\nAAPL,Apple Inc.,Technology\n...",
      "blob": null
    }
  ]
}

"fundamental_analysis"サーバーの"file:///data/sp500.csv"リソースを読み込んでください

{
  "server": "fundamental_analysis",
  "prompts": [
    {
      "name": "analyze_company",
      "description": "企業分析を行うプロンプト",
      "arguments": [
        {
          "name": "ticker",
          "description": "ティッカーシンボル",
          "required": true
        }
      ]
    }
  ]
}

"fundamental_analysis"サーバーのプロンプトテンプレート一覧を取得してください

{
  "server": "fundamental_analysis",
  "name": "analyze_company",
  "messages": [
    {
      "role": "user",
      "content": {
        "type": "text",
        "text": "Analyze AAPL company using fundamental analysis..."
      }
    }
  ]
}

"fundamental_analysis"サーバーの"analyze_company"プロンプトを
引数 {"ticker": "AAPL"} で取得してください

{
  "server": "fundamental_analysis",
  "logs": [
    {
      "timestamp": "2025-11-18T12:00:00Z",
      "server_name": "fundamental_analysis",
      "request_id": "uuid-here",
      "model_preferences": {
        "hints": [],
        "cost_priority": null,
        "speed_priority": null,
        "intelligence_priority": null
      },
      "system_prompt": null,
      "messages": [],
      "max_tokens": 1024,
      "status": "Pending",
      "error_message": null
    }
  ],
  "total_count": 1
}

"fundamental_analysis"サーバーのSamplingログを最新10件取得してください

{
  "server_name": "fundamental_analysis",
  "implementation": {
    "name": "fundamental-analysis-server",
    "title": "Financial Analysis Server",
    "version": "1.0.0",
    "website_url": "https://example.com"
  },
  "capabilities": {
    "logging": false,
    "experimental": false,
    "completions": false,
    "prompts": {
      "supported": true,
      "list_changed": false
    },
    "resources": {
      "supported": true,
      "subscribe": false,
      "list_changed": false
    },
    "tools": {
      "supported": true,
      "list_changed": false
    }
  },
  "connection_status": "connected",
  "protocol_version": "2024-11-05",
  "instructions": null
}

"fundamental_analysis"サーバーの設定情報を取得してください

{
  "server_name": "fundamental_analysis",
  "status": "healthy",
  "response_time_ms": 45,
  "last_check": "2025-11-18T10:30:00Z",
  "error_count": 0,
  "error_rate": 0.0,
  "details": null
}

"fundamental_analysis"サーバーのヘルスチェックを実行してください

{
  "server_name": "fundamental_analysis",
  "messages": [
    {
      "timestamp": "2025-11-18T10:30:00Z",
      "server_name": "fundamental_analysis",
      "level": "info",
      "logger": "app.service",
      "message": "Request processed successfully"
    }
  ],
  "total_count": 1
}

"fundamental_analysis"サーバーのエラーレベル以上のログを最新50件取得してください

"my_server"という名前で"C:/path/to/server.exe"をMCP Inspectorに登録してください

"my_server"をMCP Inspectorから削除してください

{
  "servers": [
    {
      "name": "fundamental_analysis",
      "transport": "stdio",
      "command": "C:/path/to/fa.exe",
      "args": [],
      "env": {}
    }
  ]
}

MCP Inspectorに登録されているサーバーの一覧を教えてください

["fundamental_analysis", "technical_analysis"]の2つのサーバーのツール一覧を一度に取得してください

["fundamental_analysis", "technical_analysis"]の2つのサーバーのリソース一覧を一度に取得してください

初回接続: 150ms
2回目以降: 60ms（60%短縮）

キャッシュミス: 120ms
キャッシュヒット: 0.8ms（150倍高速化）

3サーバーを順次処理: 360ms（各120ms）
3サーバーを並列処理: 130ms（約64%短縮）

No server configuration provided. Use --server or MCP_INSPECTOR_SERVERS env var

Server not found: xxx

Failed to parse config file: expected value at line X column Y

Failed to connect to server: xxx

Connection timeout after 5000ms

{
  "servers": [...],
  "logging": {...},
  "execution_config": {
    "connection_timeout_ms": 15000
  }
}

{
  "error": {
    "type": "Timeout",
    "tool_name": "slow_operation",
    "elapsed_ms": 30500,
    "configured_timeout_ms": 30000
  }
}

{
  "execution_config": {
    "tool_timeout_ms": 120000
  }
}

WARN Warning: Server 'xxx' does not support tools capability, but attempting to call tool 'yyy'

{
  "error": {
    "type": "ServerCrash",
    "message": "Server process terminated unexpectedly"
  }
}

{
  "servers": [
    {
      "name": "my_server",
      "transport": "stdio",
      "command": "/path/to/server",
      "env": {
        "API_KEY": "${API_KEY}"
      }
    }
  ]
}

{
  "execution_config": {
    "tool_timeout_ms": 120000
  }
}

src/
├── main.rs              # エントリーポイント
├── lib.rs               # ライブラリルート
├── server/              # MCPサーバー実装
│   └── mod.rs          # ツール定義とハンドラー
├── client/              # MCPクライアント実装
│   ├── mod.rs
│   ├── manager.rs      # クライアント管理
│   └── stdio_client.rs # Stdioトランスポート
├── services/            # ビジネスロジック
│   ├── mod.rs
│   ├── inspector.rs    # Inspector機能
│   ├── sampling_logger.rs # Samplingログ管理（Facade）
│   ├── logger_backend.rs  # LoggerBackendトレイト
│   ├── memory_logger.rs   # メモリバックエンド
│   ├── persistent_logger.rs # 永続化バックエンド
│   └── logger_factory.rs  # Factoryパターン
└── models/              # データ構造
    ├── mod.rs
    ├── error.rs        # エラー型
    ├── request.rs      # リクエスト型
    ├── response.rs     # レスポンス型
    ├── server_config.rs # サーバー設定
    └── logging_config.rs # ログ設定

mcp_inspector_mcp/
├── src/                 # ソースコード
├── target/              # ビルド成果物
│   └── release/
│       ├── mcp_inspector_mcp.exe (Windows)
│       ├── mcp_inspector_mcp (macOS/Linux)
│       └── .inspector/  # 設定ファイル（自動生成）
│           └── config.json
├── docs/                # ドキュメント
│   ├── INTEGRATION_TEST.md
│   ├── PHASE4_COMPLETION_REPORT.md
│   └── images/          # スクリーンショット配置場所（将来）
│       ├── logo.png
│       ├── tool-example-*.png
│       └── config-example.png
├── Cargo.toml           # Rust依存関係
├── Cargo.lock
├── README.md            # 本ファイル
└── LICENSE              # MITライセンス

# コンパイルチェック（最速）
cargo check

# Clippy（リンター）
cargo clippy

# フォーマットチェック
cargo fmt --check

# デバッグビルド
cargo build

# リリースビルド（最適化有効）
cargo build --release

# すべてのテスト実行
cargo test

# 特定のテスト実行
cargo test sampling_logger

# テスト出力を表示
cargo test -- --nocapture

# 詳細ログ付きテスト
RUST_LOG=debug cargo test

# デバッグ実行
cargo run

# リリースビルドで実行
cargo run --release

# ログ出力有効
RUST_LOG=info cargo run --release

# ツール一覧の確認
npx @modelcontextprotocol/inspector --cli -- \
  cargo run --release --method tools/list

# ツール実行
npx @modelcontextprotocol/inspector --cli -- \
  cargo run --release --method tools/call \
  --tool-name tools_list \
  --tool-arg server=fundamental_analysis