Mcp Debug

io.github.standardbeagle由 GitHub 帳號 standardbeagle 發布v1.1.6更新於 Oct 24, 2026

Debug and develop MCP servers with hot-swapping, session recording, and playback testing

已驗證STDIO僅桌面開發者工具安全與監控

概覽

AI 產生的概覽

一款用於 MCP 伺服器的開發代理，支援熱替換伺服器執行檔、錄製 JSON-RPC 工作階段並回放測試。

可以做什麼
MCP Debug 以代理形式執行於一個或多個 MCP 伺服器之前，為工具加上前綴進行聚合，並提供 server_add、server_remove、server_disconnect、server_reconnect、server_list 等管理工具。它能把 JSON-RPC 流量錄製到工作階段檔案，並以用戶端或伺服器模式回放，用於回歸測試。另提供 config init/show/validate、環境檢查與工具列表等命令列指令。
適用情境
適合在開發或除錯自己的 MCP 伺服器時使用，例如想在不重啟用戶端的情況下替換伺服器執行檔、檢視或回放已錄製的工作階段，或在開發期間把多個伺服器聚合到同一個端點後面。
執行需求
透過 stdio 在本機執行。可用 uvx（Python）、npx（Node.js）、pip、npm 或 Go 建置安裝。代理模式需要 YAML 設定檔。選用環境變數包括 MCP_LOG_FILE、MCP_DEBUG、MCP_RECORD_FILE 與 MCP_CONFIG_PATH。未宣告驗證機制。
安裝前請注意
此代理會依設定中的指令啟動並管理其他伺服器行程，因此只應指向你信任的指令。錄製會把 JSON-RPC 流量（可能包含工具參數與結果）寫入工作階段檔案，應將這些檔案視為敏感資料。管理工具可以新增、移除、中斷與重新連線伺服器。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Debug，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

MCP Debug

A debugging and development tool for Model Context Protocol (MCP) servers.

[Go Version] [MCP Spec] [License: MIT] [PyPI] [npm]

MCP Debug enables rapid development and testing of MCP servers with hot-swapping, session recording, and automated playback testing.

Features

Hot-Swap Development

  • Replace server binaries without disconnecting MCP clients
  • Add/remove servers dynamically during development
  • Tool name preservation - same interface, new implementation
  • Graceful disconnect/reconnect workflow for binary replacement

Session Recording & Playback

  • Record JSON-RPC traffic for debugging and documentation
  • Playback client mode - replay requests to test servers
  • Playback server mode - replay responses to test clients
  • Regression testing with recorded sessions

Development Proxy

  • Multi-server aggregation with tool prefixing
  • Real-time connection monitoring
  • Management API for server lifecycle control
  • Comprehensive logging

Installation

bash
# Using uvx (Python - recommended)uvx mcp-debug --help
# Using npx (Node.js)npx @standardbeagle/mcp-debug --help
# Or install globallypip install mcp-debug              # Pythonnpm install -g @standardbeagle/mcp-debug  # Node.js
# Or build from sourcego install github.com/standardbeagle/mcp-debug@latest

Quick Start

bash
# Start proxy with a config fileuvx mcp-debug --proxy --config config.yaml
# Or with mcp-tui for interactive testingmcp-tui uvx mcp-debug --proxy --config config.yaml

Usage

Proxy Mode

bash
# Basic proxyuvx mcp-debug --proxy --config config.yaml
# With recordinguvx mcp-debug --proxy --config config.yaml --record session.jsonl
# With custom log fileuvx mcp-debug --proxy --config config.yaml --log /tmp/debug.log

Management Tools:

  • server_add - Add a server: {name: "fs", command: "npx -y @mcp/filesystem /path"}
  • server_remove - Remove server completely
  • server_disconnect - Disconnect server (tools return errors)
  • server_reconnect - Reconnect with new command
  • server_list - Show all servers and status

Playback Modes

bash
# Replay recorded requests to test a serveruvx mcp-debug --playback-client session.jsonl | ./your-mcp-server
# Replay recorded responses to test a clientmcp-tui uvx mcp-debug --playback-server session.jsonl

Configuration

yaml
# config.yamlservers:  - name: "filesystem"    prefix: "fs"    transport: "stdio"    command: "npx"    args: ["-y", "@modelcontextprotocol/filesystem", "/home/user"]    timeout: "30s"
proxy:  healthCheckInterval: "30s"  connectionTimeout: "10s"  maxRetries: 3

Environment Variables

bash
MCP_LOG_FILE="/tmp/mcp-debug.log"  # Log locationMCP_DEBUG=1                         # Enable debug loggingMCP_RECORD_FILE="session.jsonl"     # Auto-record sessionsMCP_CONFIG_PATH="./config.yaml"     # Default config

Development Workflow

bash
# 1. Start with empty configmcp-tui uvx mcp-debug --proxy --config empty-config.yaml
# 2. Add your server dynamicallyserver_add: {name: myserver, command: ./my-server-v1}
# 3. Test tools: myserver_read_file, myserver_process, etc.
# 4. Make changes and rebuildgo build -o my-server-v2
# 5. Hot-swap the serverserver_disconnect: {name: myserver}server_reconnect: {name: myserver, command: ./my-server-v2}
# 6. Same tools work immediately with new implementation!

CLI Commands

bash
uvx mcp-debug --help              # Show helpuvx mcp-debug --version           # Show versionuvx mcp-debug config init         # Create default configuvx mcp-debug config show         # Show current configuvx mcp-debug config validate     # Validate config fileuvx mcp-debug env list            # List environment variablesuvx mcp-debug env check           # Check required env varsuvx mcp-debug tools list          # List tools with details

Project Structure

mcp-debug/├── main.go              # CLI entry point├── config/              # Configuration loading├── client/              # MCP client implementation├── integration/         # Proxy server and wrapper├── discovery/           # Tool discovery├── proxy/               # Request forwarding├── playback/            # Recording and playback└── test-servers/        # Example MCP servers

Building

bash
# Development buildgo build -o mcp-debug .
# Production build with version infogo build -ldflags "-X main.BuildTime=$(date -u +%Y-%m-%dT%H:%M:%SZ) -X main.GitCommit=$(git rev-parse HEAD)" -o mcp-debug .
# Run testsgo test ./...

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.

來源：README.md，提交 28f7706

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.1.6最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分