Skip to content
Back to search

mcp-probe

A Model Context Protocol (MCP) client library and debugging toolkit in Rust. This foundation provides both a production-ready SDK for building MCP integrations and the core architecture for an interactive debugger.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/conikeec--mcp-probe/badge.svg)](/listings/conikeec--mcp-probe)

HTML

<a href="/listings/conikeec--mcp-probe"><img src="/api/listings/conikeec--mcp-probe/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

MCP Probe offers multiple installation methods for your convenience:

๐Ÿ“ฅ Pre-built Binaries (Recommended)

Download the latest binary for your platform from [GitHub Releases](https://github.com/conikeec/mcp-probe/releases/latest):

- **Linux (x86_64)**: `mcp-probe-x86_64-unknown-linux-gnu.tar.gz` - **Linux (ARM64)**: `mcp-probe-aarch64-unknown-linux-gnu.tar.gz` - **macOS (Intel)**: `mcp-probe-x86_64-apple-darwin.tar.gz` - **macOS (Apple Silicon)**: `mcp-probe-aarch64-apple-darwin.tar.gz` - **Windows (x86_64)**: `mcp-probe-x86_64-pc-windows-msvc.zip`

๐ŸŒ One-liner Install (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/conikeec/mcp-probe/master/install.sh | bash

**Custom installation directory:**

curl -fsSL https://raw.githubusercontent.com/conikeec/mcp-probe/master/install.sh | INSTALL_DIR=~/.local/bin bash

**Install specific version:**

curl -fsSL https://raw.githubusercontent.com/conikeec/mcp-probe/master/install.sh | VERSION=v0.1.55 bash

๐Ÿบ Homebrew (macOS/Linux)

# Add the tap
brew tap conikeec/tap

# Install mcp-probe
brew install mcp-probe

# Or in one command
brew install conikeec/tap/mcp-probe

**Update:**

brew upgrade mcp-probe

๐Ÿ“ฆ Cargo Install

cargo install mcp-cli

**Note**: The binary will be named `mcp-probe` even though the crate is `mcp-cli`.

๐Ÿ”จ From Source

# Clone the repository
git clone https://github.com/conikeec/mcp-probe.git
cd mcp-probe

# Build and install
cargo build --release
cargo install --path .

# Or run directly
cargo run -- --help

๐Ÿ›ก๏ธ Verification

All binaries are provided with SHA256 checksums. You can verify your download:

# Download checksum file
curl -LO https://github.com/conikeec/mcp-probe/releases/latest/download/mcp-probe-x86_64-unknown-linux-gnu.tar.gz.sha256

# Verify (Linux/macOS)
sha256sum -c mcp-probe-x86_64-unknown-linux-gnu.tar.gz.sha256

# Verify (macOS alternative)
shasum -a 256 -c mcp-probe-x86_64-apple-darwin.tar.gz.sha256

Quick Start

# Test with a local MCP server
cargo run -- debug --http-sse http://localhost:3000

# Connect to remote server
cargo run -- debug --http-sse https://api.example.com/mcp

# Use WebSocket transport
cargo run -- debug --websocket ws://localhost:8080/mcp

# STDIO mode for local development
cargo run -- debug --stdio python my_mcp_server.py

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md ยท README ยท 1,197 lines ยท 1 finding marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. [![Terminal of week](https://terminaltrove.com/assets/media/terminal_trove_tool_of_the_week_green_on_dark_grey_bg.png)](https://terminaltrove.com/mcp-probe/)
  2. # ๐Ÿ” MCP Probe - Advanced MCP Protocol Debugger & Interactive Client
  3. [![Rust](https://img.shields.io/badge/rust-1.70+-orange.svg)](https://www.rust-lang.org)
  4. [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  5. [![Version](https://img.shields.io/badge/version-0.1.0-green.svg)](Cargo.toml)
  6. ![CleanShot 2025-06-21 at 13 48 13@2x](https://github.com/user-attachments/assets/0d989e06-c852-4c02-a77a-9a451e366bbc)
  7. **MCP Probe** is a powerful Terminal User Interface (TUI) for debugging, testing, and interacting with Model Context Protocol (MCP) servers. It provides an intuitive, feature-rich alternative to command-line MCP inspectors with real-time protocol analysis, capability discovery, and interactive tool execution.
  8. ```
  9. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  10. โ”‚ ๐Ÿ” MCP PROBE ARCHITECTURE โ”‚
  11. โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
  12. โ”‚ โ”‚
  13. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  14. โ”‚ โ”‚ ๐Ÿ–ฅ๏ธ TUI โ”‚ โ”‚ ๐Ÿ”Œ Transport โ”‚ โ”‚ ๐Ÿ”ง MCP Server โ”‚ โ”‚
  15. โ”‚ โ”‚ Interface โ”‚โ—„โ”€โ”€โ–บโ”‚ Layer โ”‚โ—„โ”€โ”€โ–บโ”‚ (Any impl.) โ”‚ โ”‚
  16. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  17. โ”‚ โ”‚ โ€ข Capabilities โ”‚ โ”‚ โ€ข HTTP/SSE โ”‚ โ”‚ โ€ข Tools (373+) โ”‚ โ”‚
  18. โ”‚ โ”‚ โ€ข Search โ”‚ โ”‚ โ€ข WebSocket โ”‚ โ”‚ โ€ข Resources โ”‚ โ”‚
  19. โ”‚ โ”‚ โ€ข Response View โ”‚ โ”‚ โ€ข STDIO โ”‚ โ”‚ โ€ข Prompts โ”‚ โ”‚
  20. โ”‚ โ”‚ โ€ข Debugging โ”‚ โ”‚ โ€ข TCP โ”‚ โ”‚ โ”‚ โ”‚
  21. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  22. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  23. โ”‚ โ–ผ โ–ผ โ–ผ โ”‚
  24. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
  25. โ”‚ โ”‚ ๐Ÿ“Š REAL-TIME PROTOCOL ANALYSIS โ”‚
  26. โ”‚ โ”‚ โ€ข Message Tracing โ€ข Session Management โ€ข Error Detection โ”‚
  27. โ”‚ โ”‚ โ€ข JSON Validation โ€ข Response Formatting โ€ข Performance Metrics โ”‚
  28. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  29. โ”‚ โ”‚
  30. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  31. ```
  32. ## ๐Ÿš€ Why MCP Probe?
  33. ### vs. Traditional MCP Inspector Tools
  34. | Feature | Traditional CLI Tools | MCP Probe TUI |
  35. | ------------------------ | ---------------------- | ---------------------------------------------- |
  36. | **Capability Discovery** | Manual JSON parsing | ๐ŸŽฏ Interactive browsing with search |
  37. | **Tool Execution** | Complex curl commands | ๐Ÿ–ฑ๏ธ Point-and-click with parameter forms |
  38. | **Response Analysis** | Raw JSON dumps | ๐Ÿ“Š Multi-format viewer (Tree/Summary/Raw) |
  39. | **Error Debugging** | Scattered logs | ๐Ÿ” Centralized error tracking with suggestions |
  40. | **Session Management** | Stateless commands | ๐Ÿ’พ Persistent sessions with history |
  41. | **Multi-Transport** | Single transport focus | ๐Ÿ”Œ HTTP/SSE, WebSocket, STDIO, TCP support |
  42. | **Real-time Monitoring** | Snapshot-based | โšก Live protocol stream analysis |
  43. ### Key Advantages
  44. - **๐ŸŽฎ Interactive**: Navigate 373+ tools with fuzzy search and auto-completion
  45. - **๐Ÿ” Visual**: Color-coded responses, scrollable viewers, progress indicators
  46. - **๐Ÿ“Š Analytical**: Built-in protocol validation, message correlation, timing analysis
  47. - **๐Ÿ› ๏ธ Developer-Friendly**: Session export, parameter templates, debugging hints
  48. - **๐Ÿš€ Fast**: Rust-powered performance with async I/O and efficient TUI rendering
  49. ---
  50. ## ๐Ÿ“ฆ Installation
  51. MCP Probe offers multiple installation methods for your convenience:
  52. ### ๐Ÿ“ฅ Pre-built Binaries (Recommended)
  53. Download the latest binary for your platform from [GitHub Releases](https://github.com/conikeec/mcp-probe/releases/latest):
  54. - **Linux (x86_64)**: `mcp-probe-x86_64-unknown-linux-gnu.tar.gz`
  55. - **Linux (ARM64)**: `mcp-probe-aarch64-unknown-linux-gnu.tar.gz`
  56. - **macOS (Intel)**: `mcp-probe-x86_64-apple-darwin.tar.gz`
  57. - **macOS (Apple Silicon)**: `mcp-probe-aarch64-apple-darwin.tar.gz`
  58. - **Windows (x86_64)**: `mcp-probe-x86_64-pc-windows-msvc.zip`
  59. ### ๐ŸŒ One-liner Install (Linux/macOS)
  60. ```bash
  61. curl -fsSL https://raw.githubusercontent.com/conikeec/mcp-probe/master/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 81 on GitHub
  62. ```
  63. **Custom installation directory:**
  64. ```bash
  65. curl -fsSL https://raw.githubusercontent.com/conikeec/mcp-probe/master/install.sh | INSTALL_DIR=~/.local/bin bash
  66. ```
  67. **Install specific version:**
  68. ```bash
  69. curl -fsSL https://raw.githubusercontent.com/conikeec/mcp-probe/master/install.sh | VERSION=v0.1.55 bash
  70. ```
  71. ### ๐Ÿบ Homebrew (macOS/Linux)
  72. ```bash
  73. # Add the tap
  74. brew tap conikeec/tap
  75. # Install mcp-probe
  76. brew install mcp-probe
  77. # Or in one command
  78. brew install conikeec/tap/mcp-probe
  79. ```
  80. **Update:**
  81. ```bash
  82. brew upgrade mcp-probe
  83. ```
  84. ### ๐Ÿ“ฆ Cargo Install
  85. ```bash
  86. cargo install mcp-cli
  87. ```
  88. **Note**: The binary will be named `mcp-probe` even though the crate is `mcp-cli`.
  89. ### ๐Ÿ”จ From Source
  90. ```bash
  91. # Clone the repository
  92. git clone https://github.com/conikeec/mcp-probe.git
  93. cd mcp-probe
  94. # Build and install
  95. cargo build --release
  96. cargo install --path .
  97. # Or run directly
  98. cargo run -- --help
  99. ```
  100. ### ๐Ÿ›ก๏ธ Verification
  101. All binaries are provided with SHA256 checksums. You can verify your download:
  102. ```bash
  103. # Download checksum file
  104. curl -LO https://github.com/conikeec/mcp-probe/releases/latest/download/mcp-probe-x86_64-unknown-linux-gnu.tar.gz.sha256
  105. # Verify (Linux/macOS)
  106. sha256sum -c mcp-probe-x86_64-unknown-linux-gnu.tar.gz.sha256
  107. # Verify (macOS alternative)
  108. shasum -a 256 -c mcp-probe-x86_64-apple-darwin.tar.gz.sha256
  109. ```
  110. ### Quick Start
  111. ```bash
  112. # Test with a local MCP server
  113. cargo run -- debug --http-sse http://localhost:3000
  114. # Connect to remote server
  115. cargo run -- debug --http-sse https://api.example.com/mcp
  116. # Use WebSocket transport
  117. cargo run -- debug --websocket ws://localhost:8080/mcp
  118. # STDIO mode for local development
  119. cargo run -- debug --stdio python my_mcp_server.py
  120. ```
  121. ---
  122. ## ๐ŸŽฏ Section 1: MCP Client Usage
  123. MCP Probe serves as a comprehensive MCP client for developers and integrators who need to interact with MCP servers programmatically or interactively.
  124. ### ๐Ÿ”ง Client Configuration
  125. ```bash
  126. # Basic connection with default settings
  127. mcp-probe debug --http-sse http://localhost:3000
  128. # Advanced configuration
  129. mcp-probe debug \
  130. --http-sse http://localhost:3000 \
  131. --timeout 30 \
  132. --max-retries 3 \
  133. --session-file my_session.json
  134. ```
  135. ### ๐Ÿ’ก Interactive Workflow
  136. ```
  137. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  138. โ”‚ ๐ŸŽฎ INTERACTIVE CLIENT WORKFLOW โ”‚
  139. โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
  140. โ”‚ โ”‚
  141. โ”‚ 1๏ธโƒฃ DISCOVERY PHASE โ”‚
  142. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  143. โ”‚ โ”‚ โ”Œโ”€ Connection โ”€โ” โ”Œโ”€ Capabilities โ”€โ” โ”Œโ”€ Search & Filter โ”€โ” โ”‚ โ”‚
  144. โ”‚ โ”‚ โ”‚โ€ข Auto-detect โ”‚ โ”‚โ€ข Tools: 373 โ”‚ โ”‚โ€ข Fuzzy matching โ”‚ โ”‚ โ”‚
  145. โ”‚ โ”‚ โ”‚โ€ข Protocol โ”‚ โ”‚โ€ข Resources: 1 โ”‚ โ”‚โ€ข Category filter โ”‚ โ”‚ โ”‚
  146. โ”‚ โ”‚ โ”‚โ€ข Session ID โ”‚ โ”‚โ€ข Prompts: 3 โ”‚ โ”‚โ€ข Real-time index โ”‚ โ”‚ โ”‚
  147. โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚
  148. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  149. โ”‚ โ–ผ โ”‚
  150. โ”‚ 2๏ธโƒฃ INTERACTION PHASE โ”‚
  151. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  152. โ”‚ โ”‚ โ”Œโ”€ Parameter Input โ”€โ” โ”Œโ”€ Execution โ”€โ” โ”Œโ”€ Response Analysis โ”€โ” โ”‚ โ”‚
  153. โ”‚ โ”‚ โ”‚โ€ข Smart forms โ”‚ โ”‚โ€ข Real-time โ”‚ โ”‚โ€ข Multi-format view โ”‚ โ”‚ โ”‚
  154. โ”‚ โ”‚ โ”‚โ€ข Type validation โ”‚ โ”‚โ€ข Progress โ”‚ โ”‚โ€ข Error highlighting โ”‚ โ”‚ โ”‚
  155. โ”‚ โ”‚ โ”‚โ€ข Auto-completion โ”‚ โ”‚โ€ข Correlation โ”‚ โ”‚โ€ข Export options โ”‚ โ”‚ โ”‚
  156. โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚
  157. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  158. โ”‚ โ–ผ โ”‚
  159. โ”‚ 3๏ธโƒฃ ANALYSIS PHASE โ”‚
  160. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  161. โ”‚ โ”‚ โ”Œโ”€ Session Review โ”€โ” โ”Œโ”€ Error Analysis โ”€โ” โ”Œโ”€ Export & Share โ”€โ” โ”‚ โ”‚
  162. โ”‚ โ”‚ โ”‚โ€ข Message history โ”‚ โ”‚โ€ข Root cause hints โ”‚ โ”‚โ€ข JSON export โ”‚ โ”‚ โ”‚
  163. โ”‚ โ”‚ โ”‚โ€ข Timing metrics โ”‚ โ”‚โ€ข Fix suggestions โ”‚ โ”‚โ€ข Session replay โ”‚ โ”‚ โ”‚
  164. โ”‚ โ”‚ โ”‚โ€ข Protocol trace โ”‚ โ”‚โ€ข Debug logs โ”‚ โ”‚โ€ข Report sharing โ”‚ โ”‚ โ”‚
  165. โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚
  166. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  167. โ”‚ โ”‚
  168. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  169. ```
  170. ### ๐Ÿ” Smart Capability Discovery
  171. **Fuzzy Search Engine**: Find tools instantly among hundreds of capabilities
  172. ```bash
  173. # Search examples (press '/' to activate)
  174. /github # Find GitHub-related tools
  175. /repo list # Find repository listing functions
  176. /add_numbers # Direct tool name match
  177. ```
  178. **Auto-Parameter Detection**: Intelligent form generation from JSON schemas
  179. ```bash
  180. # Example: GitHub repo listing tool
  181. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  182. โ”‚ ๐Ÿ“‹ org (REQUIRED) [string] โ”‚
  183. โ”‚ ๐Ÿ’ก The organization name... โ”‚
  184. โ”‚ > myorganization โ”‚
  185. โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
  186. โ”‚ ๐Ÿ“ per_page (optional) [integer] โ”‚
  187. โ”‚ ๐Ÿ’ก Results per page (max 100) โ”‚
  188. โ”‚ > 50 โ”‚
  189. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  190. ```
  191. ### ๐Ÿš€ Execution Patterns
  192. **Direct Command Mode**:
  193. ```bash
  194. # Syntax: category.name {"param": "value"}
  195. tools.add_numbers {"a": 10, "b": 20}
  196. resources.readme_content
  197. prompts.generate_docs {"style": "technical"}
  198. ```
  199. **Interactive Mode**: Use TUI navigation for guided execution
  200. **Batch Mode**: Execute multiple operations with session scripts
  201. ---
  202. ## ๐Ÿ” Section 2: Advanced Protocol Discovery & Session Management
  203. MCP Probe features a sophisticated protocol discovery system that automatically detects and adapts to different MCP protocol versions, providing seamless connectivity across the evolving MCP ecosystem.
  204. ### ๐Ÿš€ Intelligent Protocol Discovery
  205. **Automatic Protocol Detection**: MCP Probe automatically detects the protocol version based on endpoint patterns and server behavior, eliminating manual configuration.
  206. ```bash
  207. # MCP Probe automatically detects the protocol version from these patterns:
  208. mcp-probe debug --http-sse http://localhost:8931/mcp # Modern Streamable HTTP
  209. mcp-probe debug --http-sse http://localhost:8931/sse # Legacy HTTP+SSE
  210. mcp-probe debug --stdio python server.py # Standard Transport
  211. ```
  212. ### ๐Ÿ“Š Protocol Version Matrix
  213. | Protocol Version | Spec Date | Endpoints | Session Management | Transport Method | Status |
  214. |------------------|-----------|-----------|-------------------|------------------|---------|
  215. | **Modern Streamable HTTP** | 2025-03-26 | `/mcp` | `Mcp-Session-Id` header | HTTP/SSE Streaming | โœ… Current |
  216. | **Legacy HTTP+SSE** | 2024-11-05 | `/sse`, `/events` | `sessionId` query param | HTTP + Server-Sent Events | โœ… Supported |
  217. | **Standard Transport** | 2025-03-26 | `stdio` | N/A (process-based) | Process I/O | โœ… Supported |
  218. | **WebSocket** | 2025-03-26 | `/ws`, `/websocket` | Connection-based | WebSocket frames | ๐Ÿ”„ Planned |
  219. | **TCP** | 2025-03-26 | Raw socket | Connection-based | TCP stream | ๐Ÿ”„ Planned |
  220. ### ๐Ÿ”ง Session Negotiation Workflows
  221. #### Modern Streamable HTTP (Recommended)
  222. ```
  223. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  224. โ”‚ ๐ŸŒŸ MODERN STREAMABLE HTTP WORKFLOW โ”‚
  225. โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
  226. โ”‚ โ”‚
  227. โ”‚ Client MCP Probe Server โ”‚
  228. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  229. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  230. โ”‚ โ”‚โ”€โ”€โ”€โ”€ 1. Connection โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚โ”€โ”€โ”€โ”€โ”€โ”€ POST /mcp โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚ โ”‚
  231. โ”‚ โ”‚ โ”‚ Mcp-Session-Id: [auto] โ”‚ โ”‚
  232. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  233. โ”‚ โ”‚โ—„โ”€โ”€โ”€ Session Created โ”€โ”€โ”€โ”€โ”€โ”‚โ—„โ”€โ”€โ”€โ”€โ”€ 200 + Session โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚ โ”‚
  234. โ”‚ โ”‚ โ”‚ Mcp-Session-Id: abc123 โ”‚ โ”‚
  235. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  236. โ”‚ โ”‚โ”€โ”€โ”€โ”€ 2. Initialize โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚โ”€โ”€โ”€โ”€โ”€โ”€ POST /mcp โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚ โ”‚
  237. โ”‚ โ”‚ โ”‚ Mcp-Session-Id: abc123 โ”‚ โ”‚
  238. โ”‚ โ”‚ โ”‚ {"method": "initialize"} โ”‚ โ”‚
  239. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  240. โ”‚ โ”‚โ—„โ”€โ”€โ”€ Capabilities โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚โ—„โ”€โ”€โ”€โ”€โ”€ 200 OK โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚ โ”‚
  241. โ”‚ โ”‚ โ”‚ Server capabilities โ”‚ โ”‚
  242. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  243. โ”‚ โ”‚โ”€โ”€โ”€โ”€ 3. Ready State โ”€โ”€โ”€โ”€โ”€โ–บโ”‚โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ Persistent โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚ โ”‚
  244. โ”‚ โ”‚ โ”‚ Session Active โ”‚ โ”‚
  245. โ”‚ โ”‚
  246. โ”‚ โœ… Single endpoint simplicity ๐Ÿ”’ Header-based security โ”‚
  247. โ”‚ โœ… Built-in session management โšก Automatic resumability โ”‚
  248. โ”‚ โœ… Firewall-friendly ๐Ÿ“Š Full streaming support โ”‚
  249. โ”‚ โ”‚
  250. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  251. ```
  252. #### Legacy HTTP+SSE (Backward Compatibility)
  253. ```
  254. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  255. โ”‚ ๐Ÿ“ก LEGACY HTTP+SSE WORKFLOW โ”‚
  256. โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
  257. โ”‚ โ”‚
  258. โ”‚ Client MCP Probe Server โ”‚
  259. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  260. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  261. โ”‚ โ”‚โ”€โ”€โ”€โ”€ 1. Discover โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚โ”€โ”€โ”€โ”€โ”€โ”€ GET /events โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚ โ”‚
  262. โ”‚ โ”‚ โ”‚ Accept: text/event-stream โ”‚ โ”‚
  263. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  264. โ”‚ โ”‚โ—„โ”€โ”€โ”€ Session Info โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚โ—„โ”€โ”€โ”€โ”€โ”€ SSE Stream โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚ โ”‚
  265. โ”‚ โ”‚ โ”‚ data: {"sessionId": "xyz"}โ”‚ โ”‚
  266. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  267. โ”‚ โ”‚โ”€โ”€โ”€โ”€ 2. Initialize โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚โ”€โ”€โ”€ POST /sse?sessionId=xyzโ”€โ–บโ”‚ โ”‚
  268. โ”‚ โ”‚ โ”‚ {"method": "initialize"} โ”‚ โ”‚
  269. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  270. โ”‚ โ”‚โ—„โ”€โ”€โ”€ Capabilities โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚โ—„โ”€โ”€โ”€โ”€โ”€ 200 OK โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚ โ”‚
  271. โ”‚ โ”‚ โ”‚ Server capabilities โ”‚ โ”‚
  272. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  273. โ”‚ โ”‚โ”€โ”€โ”€โ”€ 3. SSE Listen โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚โ”€โ”€โ”€ GET /sse?sessionId=xyzโ”€โ”€โ–บโ”‚ โ”‚
  274. โ”‚ โ”‚ โ”‚ Accept: text/event-stream โ”‚ โ”‚
  275. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  276. โ”‚ โ”‚โ—„โ”€โ”€โ”€ Event Stream โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚โ—„โ”€โ”€โ”€โ”€ SSE Messages โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚ โ”‚
  277. โ”‚ โ”‚ โ”‚ Continuous updates โ”‚ โ”‚
  278. โ”‚ โ”‚
  279. โ”‚ ๐Ÿ”„ Dual-endpoint architecture ๐Ÿ“ก Query-based sessions โ”‚
  280. โ”‚ ๐Ÿ”„ Separate discovery phase โšก Event-driven updates โ”‚
  281. โ”‚ ๐Ÿ”„ Legacy compatibility ๐Ÿ“Š SSE streaming support โ”‚
  282. โ”‚ โ”‚
  283. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  284. ```
  285. #### Standard Transport (Development)
  286. ```
  287. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  288. โ”‚ ๐Ÿ”ง STANDARD TRANSPORT WORKFLOW โ”‚
  289. โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
  290. โ”‚ โ”‚
  291. โ”‚ Client MCP Probe Process โ”‚
  292. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  293. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  294. โ”‚ โ”‚โ”€โ”€โ”€โ”€ 1. Spawn Process โ”€โ”€โ”€โ–บโ”‚โ”€โ”€โ”€โ”€โ”€โ”€ exec/spawn โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚ โ”‚
  295. โ”‚ โ”‚ โ”‚ python server.py โ”‚ โ”‚
  296. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  297. โ”‚ โ”‚โ—„โ”€โ”€โ”€ Process Ready โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚โ—„โ”€โ”€โ”€โ”€โ”€ stdin/stdout โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚ โ”‚
  298. โ”‚ โ”‚ โ”‚ Process initialization โ”‚ โ”‚
  299. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  300. โ”‚ โ”‚โ”€โ”€โ”€โ”€ 2. Initialize โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚โ”€โ”€โ”€โ”€โ”€โ”€ JSON-RPC โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚ โ”‚
  301. โ”‚ โ”‚ โ”‚ via stdin โ”‚ โ”‚
  302. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  303. โ”‚ โ”‚โ—„โ”€โ”€โ”€ Capabilities โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚โ—„โ”€โ”€โ”€โ”€โ”€ JSON-RPC โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚ โ”‚
  304. โ”‚ โ”‚ โ”‚ via stdout โ”‚ โ”‚
  305. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  306. โ”‚ โ”‚โ”€โ”€โ”€โ”€ 3. Bidirectional โ”€โ”€โ”€โ–บโ”‚โ”€โ”€โ”€โ”€ stdin/stdout pipes โ”€โ”€โ”€โ”€โ–บโ”‚ โ”‚
  307. โ”‚ โ”‚ โ”‚ Full-duplex communication โ”‚ โ”‚
  308. โ”‚ โ”‚
  309. โ”‚ ๐Ÿš€ Direct process control ๐Ÿ”ง Perfect for development โ”‚
  310. โ”‚ ๐Ÿš€ No network complexity โšก Immediate debugging โ”‚
  311. โ”‚ ๐Ÿš€ Local filesystem access ๐Ÿ“Š Full protocol support โ”‚
  312. โ”‚ โ”‚
  313. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  314. ```
  315. ### ๐ŸŽฏ Interactive vs Non-Interactive Command Sequences
  316. #### Interactive Mode (TUI) - Guided Discovery
  317. ```
  318. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  319. โ”‚ ๐Ÿ–ฅ๏ธ INTERACTIVE TUI WORKFLOW โ”‚
  320. โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
  321. โ”‚ โ”‚
  322. โ”‚ Phase 1: CONNECTION & DISCOVERY โ”‚
  323. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  324. โ”‚ โ”‚ ๐Ÿ”Œ Auto-detect Protocol โ†’ ๐Ÿ“ก Establish Session โ†’ ๐Ÿ” Discover Tools โ”‚ โ”‚
  325. โ”‚ โ”‚ โ€ข Parse endpoint URL โ€ข Header/query sessions โ€ข Fuzzy search โ”‚ โ”‚
  326. โ”‚ โ”‚ โ€ข Detect /mcp vs /sse โ€ข Auto-resume capability โ€ข Category filter โ”‚ โ”‚
  327. โ”‚ โ”‚ โ€ข Security validation โ€ข Background monitoring โ€ข Real-time index โ”‚ โ”‚
  328. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  329. โ”‚ โ–ผ โ”‚
  330. โ”‚ Phase 2: INTERACTIVE EXECUTION โ”‚
  331. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  332. โ”‚ โ”‚ ๐Ÿ“‹ Parameter Forms โ†’ โšก Real-time Execution โ†’ ๐Ÿ“Š Response Analysisโ”‚ โ”‚
  333. โ”‚ โ”‚ โ€ข Smart type detection โ€ข Progress indicators โ€ข Multi-format view โ”‚ โ”‚
  334. โ”‚ โ”‚ โ€ข Schema-driven hints โ€ข Error correlation โ€ข Error highlighting โ”‚ โ”‚
  335. โ”‚ โ”‚ โ€ข Auto-completion โ€ข Session persistence โ€ข Export options โ”‚ โ”‚
  336. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  337. โ”‚ โ–ผ โ”‚
  338. โ”‚ Phase 3: ANALYSIS & DEBUGGING โ”‚
  339. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  340. โ”‚ โ”‚ ๐Ÿ“ˆ Session Review โ†’ ๐Ÿ”ง Error Investigation โ†’ ๐Ÿ“ค Export & Share โ”‚ โ”‚
  341. โ”‚ โ”‚ โ€ข Message history โ€ข Root cause analysis โ€ข JSON export โ”‚ โ”‚
  342. โ”‚ โ”‚ โ€ข Timing metrics โ€ข Fix suggestions โ€ข Session replay โ”‚ โ”‚
  343. โ”‚ โ”‚ โ€ข Protocol trace โ€ข Debug logs โ€ข Report generation โ”‚ โ”‚
  344. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  345. โ”‚ โ”‚
  346. โ”‚ ๐ŸŽฎ User Experience: Visual, guided, exploratory โ”‚
  347. โ”‚ โŒจ๏ธ Hotkeys: Tab navigation, / search, Enter execute โ”‚
  348. โ”‚ ๐Ÿ” Features: Fuzzy search, parameter forms, real-time feedback โ”‚
  349. โ”‚ โ”‚
  350. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  351. ```
  352. **Interactive Mode Commands:**
  353. ```bash
  354. # Launch TUI with automatic protocol detection
  355. mcp-probe debug --http-sse http://localhost:8931/mcp
  356. # TUI Navigation Flow:
  357. # 1. Tab โ†’ Navigate between panels
  358. # 2. / โ†’ Activate fuzzy search
  359. # 3. โ†‘โ†“ โ†’ Browse capabilities
  360. # 4. Enter โ†’ Open parameter form
  361. # 5. Tab โ†’ Execute with parameters
  362. # 6. V โ†’ Cycle response views
  363. # 7. F2 โ†’ Save session
  364. # Smart Parameter Forms:
  365. # โ€ข Auto-detects field types from JSON Schema
  366. # โ€ข Provides contextual hints and validation
  367. # โ€ข Supports environment variable injection
  368. # โ€ข Real-time syntax validation
  369. ```
  370. #### Non-Interactive Mode (CLI) - Automation-Friendly
  371. ```
  372. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  373. โ”‚ โšก NON-INTERACTIVE CLI WORKFLOW โ”‚
  374. โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
  375. โ”‚ โ”‚
  376. โ”‚ Phase 1: RAPID CONNECTION โ”‚
  377. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  378. โ”‚ โ”‚ ๐Ÿš€ Direct Connect โ†’ ๐Ÿ“Š Quick Capability Dump โ”‚ โ”‚
  379. โ”‚ โ”‚ โ€ข Protocol auto-detection โ€ข Structured output โ”‚ โ”‚
  380. โ”‚ โ”‚ โ€ข No user interaction โ€ข Machine-readable format โ”‚ โ”‚
  381. โ”‚ โ”‚ โ€ข CI/CD friendly โ€ข Error codes for automation โ”‚ โ”‚
  382. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  383. โ”‚ โ–ผ โ”‚
  384. โ”‚ Phase 2: BATCH EXECUTION โ”‚
  385. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  386. โ”‚ โ”‚ ๐Ÿ“ Command Scripts โ†’ โš™๏ธ Automated Testing โ†’ ๐Ÿ“„ Report Output โ”‚ โ”‚
  387. โ”‚ โ”‚ โ€ข Direct tool execution โ€ข Comprehensive test suite โ€ข JSON/CSV export โ”‚ โ”‚
  388. โ”‚ โ”‚ โ€ข Parameter validation โ€ข Protocol compliance โ€ข CI integration โ”‚ โ”‚
  389. โ”‚ โ”‚ โ€ข Bulk operations โ€ข Performance monitoring โ€ข Success/fail codesโ”‚ โ”‚
  390. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  391. โ”‚ โ–ผ โ”‚
  392. โ”‚ Phase 3: PRODUCTION VALIDATION โ”‚
  393. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  394. โ”‚ โ”‚ ๐Ÿ” Health Checks โ†’ ๐Ÿ“Š Performance Analysis โ†’ ๐Ÿšจ Alert Integrationโ”‚ โ”‚
  395. โ”‚ โ”‚ โ€ข Endpoint discovery โ€ข Response time metrics โ€ข Monitoring systems โ”‚ โ”‚
  396. โ”‚ โ”‚ โ€ข Protocol compliance โ€ข Memory usage tracking โ€ข Automated alerts โ”‚ โ”‚
  397. โ”‚ โ”‚ โ€ข Schema validation โ€ข Error rate analysis โ€ข Report webhooks โ”‚ โ”‚
  398. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  399. โ”‚ โ”‚
  400. โ”‚ ๐Ÿค– Use Cases: CI/CD pipelines, monitoring, automation โ”‚
  401. โ”‚ โšก Features: Zero interaction, structured output, exit codes โ”‚
  402. โ”‚ ๐Ÿ”ง Integration: Scripts, Docker, Kubernetes health checks โ”‚
  403. โ”‚ โ”‚
  404. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  405. ```
  406. **Non-Interactive Mode Commands:**
  407. ```bash
  408. # Quick capability overview
  409. mcp-probe debug --http-sse http://localhost:8931/mcp --non-interactive
  410. # Automated testing with reports
  411. mcp-probe test --http-sse http://localhost:8931/mcp --report --output-dir ./reports
  412. # Endpoint discovery for load balancers
  413. mcp-probe test --discover http://api.company.com --report
  414. # CI/CD integration examples
  415. mcp-probe test --http-sse $MCP_SERVER_URL --fail-fast --timeout 30
  416. if [ $? -eq 0 ]; then echo "โœ… MCP server healthy"; else echo "โŒ MCP server failed"; fi
  417. # Batch operations for monitoring
  418. mcp-probe validate --http-sse http://prod-server/mcp --suite compliance
  419. ```
  420. ### ๐Ÿ” Advanced Endpoint Discovery
  421. **Multi-Endpoint Discovery**: MCP Probe can discover and test multiple MCP endpoints from a base URL, perfect for load balancers and multi-service deployments.
  422. ```bash
  423. # Discover all MCP endpoints under a domain
  424. mcp-probe test --discover https://api.company.com
  425. # Discovery automatically tests these patterns:
  426. # โ€ข https://api.company.com/mcp (Modern)
  427. # โ€ข https://api.company.com/sse (Legacy)
  428. # โ€ข https://api.company.com/events (Discovery)
  429. # โ€ข https://api.company.com/v1/mcp (Versioned)
  430. # โ€ข https://api.company.com/api/mcp (Nested)
  431. # Output shows availability and capabilities:
  432. โœ… Modern Streamable HTTP - 47 tools, 3 resources, 2 prompts
  433. โœ… Legacy HTTP+SSE - 47 tools, 3 resources, 2 prompts
  434. โŒ Versioned API - Connection failed
  435. โš ๏ธ Nested API - Invalid response format
  436. ```
  437. ### ๐Ÿ›ก๏ธ Security & Session Management
  438. #### Automatic Security Validation
  439. ```
  440. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  441. โ”‚ ๐Ÿ”’ SECURITY VALIDATION โ”‚
  442. โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
  443. โ”‚ โ”‚
  444. โ”‚ ๐Ÿ›ก๏ธ Connection Security โ”‚
  445. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  446. โ”‚ โ”‚ โ€ข HTTPS enforcement for production URLs โ”‚ โ”‚
  447. โ”‚ โ”‚ โ€ข Origin validation to prevent DNS rebinding โ”‚ โ”‚
  448. โ”‚ โ”‚ โ€ข Session ID format validation (cryptographic strength) โ”‚ โ”‚
  449. โ”‚ โ”‚ โ€ข Certificate verification for remote servers โ”‚ โ”‚
  450. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  451. โ”‚ โ”‚
  452. โ”‚ ๐Ÿ” Session Management โ”‚
  453. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  454. โ”‚ โ”‚ โ€ข Automatic session discovery and renewal โ”‚ โ”‚
  455. โ”‚ โ”‚ โ€ข Secure session ID generation and tracking โ”‚ โ”‚
  456. โ”‚ โ”‚ โ€ข Background session monitoring for ephemeral servers โ”‚ โ”‚
  457. โ”‚ โ”‚ โ€ข Session resumption after network interruptions โ”‚ โ”‚
  458. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  459. โ”‚ โ”‚
  460. โ”‚ โšก Performance & Reliability โ”‚
  461. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  462. โ”‚ โ”‚ โ€ข Connection pooling and keep-alive โ”‚ โ”‚
  463. โ”‚ โ”‚ โ€ข Automatic retry with exponential backoff โ”‚ โ”‚
  464. โ”‚ โ”‚ โ€ข Request timeout and circuit breaker patterns โ”‚ โ”‚
  465. โ”‚ โ”‚ โ€ข Memory-efficient streaming for large responses โ”‚ โ”‚
  466. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  467. โ”‚ โ”‚
  468. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  469. ```
  470. ### ๐Ÿ“ˆ Protocol Compliance Testing
  471. **Comprehensive Test Suites**: MCP Probe includes extensive test suites for validating protocol compliance across different versions.
  472. ```bash
  473. # Full protocol compliance testing
  474. mcp-probe validate --http-sse http://localhost:8931/mcp --suite all
  475. # Specific compliance areas:
  476. mcp-probe validate --suite initialization # Connection & handshake
  477. mcp-probe validate --suite capabilities # Tool/resource discovery
  478. mcp-probe validate --suite schema # JSON Schema validation
  479. mcp-probe validate --suite security # Security best practices
  480. mcp-probe validate --suite performance # Response time & throughput
  481. # Generate detailed compliance reports
  482. mcp-probe validate --suite all --report --output-dir ./compliance-reports
  483. ```
  484. ---
  485. ## ๐Ÿ”ง Section 3: MCP Deployment Troubleshooting
  486. MCP Probe excels as a diagnostic tool for MCP deployments, providing deep insights into protocol behavior, performance bottlenecks, and integration issues.
  487. ### ๐Ÿšจ Diagnostic Features
  488. ```
  489. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  490. โ”‚ ๐Ÿ” TROUBLESHOOTING DASHBOARD โ”‚
  491. โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
  492. โ”‚ โ”‚
  493. โ”‚ ๐Ÿ”ด CONNECTION DIAGNOSTICS ๐ŸŸก PROTOCOL ANALYSIS โ”‚
  494. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  495. โ”‚ โ”‚ โ€ข Transport validation โ”‚ โ”‚ โ€ข Message correlation โ”‚ โ”‚
  496. โ”‚ โ”‚ โ€ข Authentication checks โ”‚ โ”‚ โ€ข Response time analysis โ”‚ โ”‚
  497. โ”‚ โ”‚ โ€ข Firewall/proxy detection โ”‚ โ”‚ โ€ข Error pattern recognition โ”‚ โ”‚
  498. โ”‚ โ”‚ โ€ข SSL/TLS verification โ”‚ โ”‚ โ€ข Capability compatibility โ”‚ โ”‚
  499. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  500. โ”‚ โ”‚
  501. โ”‚ ๐ŸŸข PERFORMANCE MONITORING ๐ŸŸฃ ERROR INVESTIGATION โ”‚
  502. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  503. โ”‚ โ”‚ โ€ข Request/response latency โ”‚ โ”‚ โ€ข Stack trace analysis โ”‚ โ”‚
  504. โ”‚ โ”‚ โ€ข Throughput measurement โ”‚ โ”‚ โ€ข JSON schema validation โ”‚ โ”‚
  505. โ”‚ โ”‚ โ€ข Memory usage tracking โ”‚ โ”‚ โ€ข Serialization debugging โ”‚ โ”‚
  506. โ”‚ โ”‚ โ€ข Connection stability โ”‚ โ”‚ โ€ข Integration compatibility โ”‚ โ”‚
  507. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  508. โ”‚ โ”‚
  509. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  510. ```
  511. ### ๐Ÿ› ๏ธ Common Issues & Solutions
  512. #### Issue 1: Connection Failures
  513. **Symptoms**: "Transport connection failed", "Connection refused"
  514. **Diagnosis with MCP Probe**:
  515. ```bash
  516. # 1. Test basic connectivity
  517. mcp-probe debug --http-sse http://localhost:3000
  518. # 2. Check different transports
  519. mcp-probe debug --websocket ws://localhost:8080/mcp
  520. mcp-probe debug --stdio python server.py
  521. # 3. Monitor protocol flow
  522. # Look for: Connection status, SSL handshake, authentication
  523. ```
  524. **Troubleshooting Guide**:
  525. - โœ… Server is running and listening on correct port
  526. - โœ… Firewall rules allow connections
  527. - โœ… SSL certificates are valid (for HTTPS)
  528. - โœ… Authentication credentials are correct
  529. #### Issue 2: Tool Execution Failures
  530. **Symptoms**: "Serialization error", "Invalid parameters", "Tool not found"
  531. **Diagnosis with MCP Probe**:
  532. ```bash
  533. # 1. Verify tool discovery
  534. # Navigate to Tools section, check tool list
  535. # 2. Inspect parameter schemas
  536. # Select tool -> Parameter form should show required fields
  537. # 3. Check raw response data
  538. # Use 'V' key to cycle through response formats
  539. ```
  540. **Common Root Causes**:
  541. - ๐Ÿ”ง **Parameter Mismatch**: Use Parameter Form to validate inputs
  542. - ๐Ÿ”ง **Tool Name Prefix Issues**: Check clean vs. full tool names
  543. - ๐Ÿ”ง **JSON Format Errors**: Validate JSON in response viewer
  544. - ๐Ÿ”ง **Server-Side Errors**: Review error messages in message history
  545. #### Issue 3: Performance Problems
  546. **Symptoms**: Slow responses, timeouts, memory issues
  547. **Diagnosis with MCP Probe**:
  548. ```bash
  549. # 1. Monitor timing metrics
  550. # Check message history for response times
  551. # 2. Analyze message sizes
  552. # Use Raw JSON view to inspect payload sizes
  553. # 3. Track connection stability
  554. # Watch for reconnection attempts in logs
  555. ```
  556. ### ๐Ÿ“Š Protocol Debugging
  557. **Message Flow Analysis**:
  558. ```
  559. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  560. โ”‚ ๐Ÿ“ˆ PROTOCOL MESSAGE FLOW โ”‚
  561. โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
  562. โ”‚ โ”‚
  563. โ”‚ Client MCP Probe Server โ”‚
  564. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  565. โ”‚ โ”‚โ”€โ”€โ”€โ”€ initialize โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚โ”€โ”€โ”€โ”€โ”€โ”€ HTTP/POST โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚ โ”‚
  566. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  567. โ”‚ โ”‚โ—„โ”€โ”€โ”€ init_response โ”€โ”€โ”€โ”€โ”€โ”€โ”‚โ—„โ”€โ”€โ”€โ”€โ”€ 200 OK โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚ โ”‚
  568. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  569. โ”‚ โ”‚โ”€โ”€โ”€โ”€ tools/list โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚โ”€โ”€โ”€โ”€โ”€โ”€ HTTP/POST โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚ โ”‚
  570. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  571. โ”‚ โ”‚โ—„โ”€โ”€โ”€ tools_response โ”€โ”€โ”€โ”€โ”€โ”‚โ—„โ”€โ”€โ”€โ”€โ”€ 200 OK โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚ โ”‚
  572. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  573. โ”‚ โ”‚โ”€โ”€โ”€โ”€ tools/call โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚โ”€โ”€โ”€โ”€โ”€โ”€ HTTP/POST โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚ โ”‚
  574. โ”‚ โ”‚ โ”‚ (params) โ”‚ โ”‚
  575. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  576. โ”‚ โ”‚โ—„โ”€โ”€โ”€ result/error โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚โ—„โ”€โ”€โ”€โ”€โ”€ 200/400/500 โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚ โ”‚
  577. โ”‚ โ”‚ โ”‚ โ”‚ โ”‚
  578. โ”‚ โ”‚
  579. โ”‚ ๐Ÿ” MCP Probe captures and analyzes each step: โ”‚
  580. โ”‚ โ€ข Request correlation (session ID tracking) โ”‚
  581. โ”‚ โ€ข Response time measurement โ”‚
  582. โ”‚ โ€ข Error classification and suggestions โ”‚
  583. โ”‚ โ€ข JSON schema validation โ”‚
  584. โ”‚ โ”‚
  585. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  586. ```
  587. ### ๐ŸŽฏ Environment Validation
  588. **Development Environment Checklist**:
  589. ```bash
  590. # 1. Server Implementation Validation
  591. โœ… Server responds to initialize request
  592. โœ… Capabilities are properly declared
  593. โœ… Tool schemas are valid JSON Schema
  594. โœ… Error responses include helpful messages
  595. # 2. Integration Testing
  596. โœ… Authentication flow works correctly
  597. โœ… Session management is stable
  598. โœ… All transport types are supported
  599. โœ… Error handling is graceful
  600. # 3. Performance Validation
  601. โœ… Response times are within SLA
  602. โœ… Memory usage is reasonable
  603. โœ… Concurrent requests are handled
  604. โœ… Rate limiting is implemented correctly
  605. ```
  606. ---
  607. ## ๐Ÿ“š Command Cheat Sheet
  608. ### ๐Ÿ”ง Basic Commands
  609. ```bash
  610. # Connection
  611. mcp-probe debug --http-sse <url> # HTTP Server-Sent Events
  612. mcp-probe debug --websocket <url> # WebSocket connection
  613. mcp-probe debug --stdio <command> # STDIO transport
  614. mcp-probe debug --tcp <host:port> # Raw TCP connection
  615. # Configuration
  616. mcp-probe debug <transport> --timeout 30 # Request timeout
  617. mcp-probe debug <transport> --max-retries 3 # Retry attempts
  618. mcp-probe debug <transport> --session-file <f> # Session persistence
  619. ```
  620. ### โŒจ๏ธ TUI Navigation Hotkeys
  621. #### Global Navigation
  622. | Key | Action | Description |
  623. | ----- | ------------- | ------------------------- |
  624. | `Tab` | Cycle Focus | Move between panels |
  625. | `F1` | Help | Show/hide help dialog |
  626. | `F2` | Save Session | Export current session |
  627. | `F3` | Toggle JSON | Switch JSON view mode |
  628. | `F4` | Clear History | Reset message history |
  629. | `F5` | Environment | Set environment variables |
  630. | `Q` | Quit | Exit application |
  631. #### Capability Browser
  632. | Key | Action | Description |
  633. | ------- | -------- | ----------------------------- |
  634. | `Enter` | Select | Open capability details |
  635. | `โ†‘/โ†“` | Navigate | Move through categories/items |
  636. | `โ†/โ†’` | Page | Previous/next page |
  637. | `/` | Search | Activate fuzzy search |
  638. | `Esc` | Back | Return to categories |
  639. #### Search Interface
  640. | Key | Action | Description |
  641. | ------- | -------- | --------------------- |
  642. | `/` | Activate | Open search dialog |
  643. | `Type` | Query | Enter search terms |
  644. | `โ†‘/โ†“` | Navigate | Browse search results |
  645. | `Enter` | Select | Choose result |
  646. | `Esc` | Cancel | Close search |
  647. #### Parameter Forms
  648. | Key | Action | Description |
  649. | ------- | -------- | ------------------------------- |
  650. | `โ†‘/โ†“` | Navigate | Move between fields (auto-edit) |
  651. | `Type` | Edit | Enter parameter values |
  652. | `Enter` | Save | Save field and move to next |
  653. | `Tab` | Execute | Run with current parameters |
  654. | `Esc` | Cancel | Close parameter form |
  655. #### Response Viewer
  656. | Key | Action | Description |
  657. | ----------- | ----------- | ------------------------------------------ |
  658. | `R` | Open | View selected response |
  659. | `V` | View Mode | Cycle formats (Formatted/Raw/Tree/Summary) |
  660. | `โ†‘/โ†“` | Scroll V | Vertical scrolling |
  661. | `โ†/โ†’` | Scroll H | Horizontal scrolling |
  662. | `PgUp/PgDn` | Fast Scroll | Page up/down |
  663. | `Home/End` | Jump | Go to top/bottom |
  664. | `Esc` | Close | Exit response viewer |
  665. ### ๐ŸŽฎ Interactive Commands
  666. #### Direct Tool Execution
  667. ```bash
  668. # Syntax: category.name {json_params}
  669. tools.add_numbers {"a": 10, "b": 20}
  670. tools.github_list_repos {"org": "microsoft", "per_page": 10}
  671. resources.readme_content
  672. prompts.code_review {"language": "rust", "style": "detailed"}
  673. ```
  674. #### Environment Variables
  675. ```bash
  676. # Set variables for tool injection
  677. KEY=value,API_TOKEN=secret123,ORG=myorg
  678. # Variables automatically injected into tool calls
  679. tools.api_call {} # Will include ORG=myorg if tool expects it
  680. ```
  681. ---
  682. ## ๐Ÿ“ File System Organization
  683. MCP Probe automatically organizes all generated files in a clean, structured directory hierarchy in your home directory.
  684. ### ๐Ÿ  Directory Structure
  685. ```
  686. ~/.mcp-probe/
  687. โ”œโ”€โ”€ logs/ # All log files with timestamps
  688. โ”‚ โ”œโ”€โ”€ mcp-probe-debug.log # TUI mode debug log
  689. โ”‚ โ””โ”€โ”€ mcp-probe-YYYYMMDD_HHMMSS.log # CLI mode logs
  690. โ”œโ”€โ”€ reports/ # All generated reports with date prefixes
  691. โ”‚ โ”œโ”€โ”€ YYYYMMDD-test-report-HHMMSS.json
  692. โ”‚ โ”œโ”€โ”€ YYYYMMDD-validation-report-HHMMSS.json
  693. โ”‚ โ””โ”€โ”€ YYYYMMDD-discovery-report-HHMMSS.json
  694. โ”œโ”€โ”€ sessions/ # Saved session files
  695. โ”‚ โ””โ”€โ”€ debug-session-YYYYMMDD_HHMMSS.json
  696. โ””โ”€โ”€ config/ # Configuration files
  697. โ””โ”€โ”€ mcp-probe.toml
  698. ```
  699. ### ๐Ÿ—‚๏ธ Path Management Commands
  700. ```bash
  701. # Show directory structure and usage
  702. mcp-probe paths show
  703. # Clean up old files (dry run)
  704. mcp-probe paths cleanup --days 30
  705. # Actually clean up files older than 7 days
  706. mcp-probe paths cleanup --days 7 --force
  707. # Open MCP Probe directory in file manager
  708. mcp-probe paths open
  709. ```
  710. ### ๐Ÿ“… Automatic Date Prefixing
  711. All reports are automatically prefixed with dates for easy organization:
  712. - **Format**: `YYYYMMDD-report-name-HHMMSS.extension`
  713. - **Example**: `20250622-test-report-143052.json`
  714. - **Benefits**: Chronological sorting, easy cleanup, no file conflicts
  715. ### ๐Ÿงน Automated Cleanup
  716. MCP Probe includes intelligent cleanup features:
  717. ```bash
  718. # Show what would be cleaned up
  719. mcp-probe paths cleanup --days 30
  720. # Clean files older than 30 days
  721. mcp-probe paths cleanup --days 30 --force
  722. # The paths show command gives cleanup recommendations
  723. mcp-probe paths show
  724. ```
  725. ---
  726. ## ๐Ÿ” Advanced Features
  727. ### ๐Ÿ“Š Response Analysis Modes
  728. #### 1. **Formatted View** (Default)
  729. - โœจ Syntax highlighting for JSON
  730. - ๐Ÿ“‹ Structured analysis with field breakdown
  731. - ๐Ÿ” Error highlighting and suggestions
  732. - ๐Ÿ“ˆ Content statistics and metadata
  733. #### 2. **Raw JSON View**
  734. - ๐Ÿ“„ Pretty-printed JSON output
  735. - ๐Ÿ” Full response data visibility
  736. - ๐Ÿ“‹ Copy-friendly format
  737. - ๐Ÿ› ๏ธ Debug-oriented display
  738. #### 3. **Tree View**
  739. - ๐ŸŒณ Hierarchical data visualization
  740. - ๐Ÿ“ Collapsible object/array nodes
  741. - ๐Ÿ“Š Type indicators for each field
  742. - ๐ŸŽฏ Easy navigation of nested structures
  743. #### 4. **Summary View**
  744. - ๐Ÿ“ˆ High-level response overview
  745. - ๐Ÿ“Š Key metrics and statistics
  746. - โšก Quick status assessment
  747. - ๐ŸŽฏ Action-oriented insights
  748. ### ๐Ÿ”’ Session Management
  749. ```bash
  750. # Auto-save sessions
  751. mcp-probe debug --http-sse http://localhost:3000 --session-file debug.json
  752. # Session contains:
  753. # โ€ข Connection parameters
  754. # โ€ข Message history with timing
  755. # โ€ข Error logs and diagnostics
  756. # โ€ข Environment variables
  757. # โ€ข Response cache for offline analysis
  758. ```
  759. ### ๐ŸŒ Multi-Transport Support
  760. #### HTTP Server-Sent Events (Recommended)
  761. ```bash
  762. mcp-probe debug --http-sse http://localhost:3000
  763. # โœ… Most compatible with web servers
  764. # โœ… Firewall-friendly
  765. # โœ… Built-in error handling
  766. ```
  767. #### WebSocket
  768. ```bash
  769. mcp-probe debug --websocket ws://localhost:8080/mcp
  770. # โœ… Real-time bidirectional communication
  771. # โœ… Lower latency
  772. # โš ๏ธ May require proxy configuration
  773. ```
  774. #### STDIO (Development)
  775. ```bash
  776. mcp-probe debug --stdio python my_server.py
  777. # โœ… Perfect for local testing
  778. # โœ… Direct process communication
  779. # โš ๏ธ Limited to local development
  780. ```
  781. #### TCP (Advanced)
  782. ```bash
  783. mcp-probe debug --tcp localhost:9000
  784. # โœ… Low-level protocol access
  785. # โœ… Custom transport implementations
  786. # โš ๏ธ Requires manual protocol handling
  787. ```
  788. ---
  789. ## ๐Ÿ› ๏ธ Development & Contributing
  790. ### Project Structure
  791. ```
  792. mcp-probe/
  793. โ”œโ”€โ”€ crates/
  794. โ”‚ โ”œโ”€โ”€ mcp-core/ # Core MCP protocol implementation
  795. โ”‚ โ”‚ โ”œโ”€โ”€ src/
  796. โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ client.rs # High-level MCP client
  797. โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ transport/ # Transport layer abstractions
  798. โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ messages/ # Protocol message definitions
  799. โ”‚ โ”‚ โ””โ”€โ”€ Cargo.toml
  800. โ”‚ โ””โ”€โ”€ mcp-cli/ # TUI application
  801. โ”‚ โ”œโ”€โ”€ src/
  802. โ”‚ โ”‚ โ”œโ”€โ”€ tui.rs # Terminal UI implementation
  803. โ”‚ โ”‚ โ”œโ”€โ”€ search.rs # Capability search engine
  804. โ”‚ โ”‚ โ””โ”€โ”€ main.rs # CLI entry point
  805. โ”‚ โ””โ”€โ”€ Cargo.toml
  806. โ”œโ”€โ”€ target/ # Build artifacts
  807. โ”œโ”€โ”€ Cargo.toml # Workspace configuration
  808. โ””โ”€โ”€ README.md
  809. ```
  810. ### Building from Source
  811. ```bash
  812. # Debug build
  813. cargo build
  814. # Release build (recommended for performance)
  815. cargo build --release
  816. # Run tests
  817. cargo test
  818. # Run with logging
  819. RUST_LOG=debug cargo run -- debug --http-sse http://localhost:3000
  820. ```
  821. ### Contributing Guidelines
  822. 1. ๐Ÿด Fork the repository
  823. 2. ๐ŸŒฟ Create a feature branch
  824. 3. โœ… Add tests for new functionality
  825. 4. ๐Ÿ“ Update documentation
  826. 5. ๐Ÿ”„ Submit a pull request
  827. ---
  828. ## ๐Ÿ“„ License
  829. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  830. ---
  831. ## ๐Ÿค Support & Community
  832. - **๐Ÿ“– Documentation**: [docs.example.com/mcp-probe](docs.example.com/mcp-probe)
  833. - **๐Ÿ› Issues**: [GitHub Issues](https://github.com/your-org/mcp-probe/issues)
  834. - **๐Ÿ’ฌ Discussions**: [GitHub Discussions](https://github.com/your-org/mcp-probe/discussions)
  835. - **๐Ÿ”ง Contributing**: See [CONTRIBUTING.md](CONTRIBUTING.md)
  836. ---
  837. ## ๐Ÿš€ Quick Examples
  838. ### Example 1: Debug API Integration
  839. ```bash
  840. # Connect to your MCP server
  841. mcp-probe debug --http-sse https://api.yourservice.com/mcp
  842. # 1. Verify connection and capabilities
  843. # 2. Search for relevant tools: /api or /user
  844. # 3. Test tool execution with real parameters
  845. # 4. Analyze responses for integration issues
  846. # 5. Export session for team sharing
  847. ```
  848. ### Example 2: Performance Testing
  849. ```bash
  850. # Set up performance monitoring
  851. mcp-probe debug --http-sse http://localhost:3000 --session-file perf_test.json
  852. # 1. Execute high-frequency tool calls
  853. # 2. Monitor response times in message history
  854. # 3. Check for memory leaks or connection issues
  855. # 4. Review session file for timing analysis
  856. ```
  857. ### Example 3: Development Workflow
  858. ```bash
  859. # Local development testing
  860. mcp-probe debug --stdio python my_mcp_server.py
  861. # 1. Rapid iteration on server code
  862. # 2. Test tool schemas and validation
  863. # 3. Debug parameter handling
  864. # 4. Verify error response formats
  865. ```
  866. ---
  867. ## ๐Ÿ”ง Development Automation & CI/CD
  868. ### ๐Ÿš€ Automated Quality Checks
  869. MCP Probe includes comprehensive automation for code quality and CI/CD:
  870. #### Development Scripts
  871. ```bash
  872. # Run all checks (formatting, clippy, tests)
  873. ./scripts/check.sh
  874. # Auto-fix formatting and clippy issues
  875. ./scripts/fix.sh
  876. # Publish to crates.io (with all checks)
  877. ./scripts/release.sh
  878. ```
  879. #### Continuous Integration
  880. Our GitHub Actions CI pipeline automatically runs:
  881. - โœ… **Code Formatting**: `rustfmt` ensures consistent code style
  882. - โœ… **Linting**: `clippy` with warnings as errors for code quality
  883. - โœ… **Testing**: Full test suite across Linux, macOS, and Windows
  884. - โœ… **Security Audit**: `cargo audit` for vulnerability scanning
  885. - โœ… **Code Coverage**: Coverage reporting with codecov.io
  886. - โœ… **Documentation**: Automatic docs.rs generation
  887. #### Publishing Workflow
  888. Releases to crates.io are fully automated:
  889. 1. **Trigger**: Create a GitHub release
  890. 2. **Checks**: All CI checks must pass
  891. 3. **Publish**:
  892. - `mcp-core` published first (dependency)
  893. - `mcp-cli` published second
  894. 4. **Tagging**: Git tag created automatically
  895. #### Local Development Setup
  896. ```bash
  897. # Install development tools
  898. cargo install cargo-audit cargo-tarpaulin
  899. # Set up git hooks (optional)
  900. cargo install cargo-husky
  901. ```
  902. #### Code Quality Standards
  903. - **Formatting**: Enforced via `rustfmt.toml` configuration
  904. - **Linting**: Zero tolerance for clippy warnings
  905. - **Testing**: Comprehensive test coverage required
  906. - **Documentation**: All public APIs must be documented
  907. ### ๐Ÿ“ฆ Crate Publishing
  908. Both crates are available on crates.io:
  909. - **[mcp-core](https://crates.io/crates/mcp-core)**: Core MCP protocol implementation
  910. - **[mcp-cli](https://crates.io/crates/mcp-cli)**: Interactive TUI debugger
  911. #### Installation
  912. ```bash
  913. # Install the CLI tool
  914. cargo install mcp-cli
  915. # Add core library to your project
  916. [dependencies]
  917. mcp-core = "0.1.0"
  918. ```
  919. ---
  920. ## ๐Ÿ’ Credits & Acknowledgments
  921. **Made with โค๏ธ in Rust**
  922. This project wouldn't be possible without:
  923. - ๐Ÿฆ€ **[Rust Programming Language](https://rust-lang.org/)** - For memory safety, performance, and the amazing ecosystem that makes systems programming a joy
  924. - ๐Ÿค– **[Anthropic](https://anthropic.com/)** - For creating the Model Context Protocol (MCP) specification and advancing the field of AI collaboration tools
  925. - ๐ŸŒŸ **The Rust Community** - For the incredible crates that power MCP Probe: Ratatui, Tokio, Serde, Clap, and countless others
  926. - ๐Ÿ› ๏ธ **Open Source Contributors** - Every bug report, feature suggestion, and pull request makes this tool better
  927. Special thanks to the Ratatui team for creating the foundation that makes our beautiful TUI possible! ๐ŸŽจ
  928. ---
  929. **๐ŸŽฏ MCP Probe: Making MCP protocol debugging as intuitive as it should be.**

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If itโ€™s helped, pass it on.