giantswarm/mcp-debug

View on GitHub ↗

Command-line tool for debugging MCP servers

37 ★1 forksGoUpdated 18d ago

What you need to know

CLI tool for debugging MCP servers over streamable-http transport. Provides an interactive REPL, an MCP server mode for AI-assistant integration, full OAuth 2.1 (MCP authorization spec 2025-11-25) including CIMD and dynamic client registration, verbose JSON-RPC logging, self-update, and shell autocompletion.

Install

go install github.com/giantswarm/mcp-debug@latest

Usage

  • •Connect to an MCP server endpoint (mcp-debug --endpoint URL), explore with --repl, or run as an MCP server with --mcp-server.

Key features

  • ✓Connect to any streamable-http MCP server
  • ✓OAuth 2.1 with CIMD and dynamic client registration
  • ✓Interactive REPL
  • ✓MCP server mode
  • ✓Verbose JSON-RPC logging
  • ✓Self-update and shell autocompletion

Best for

Debugging MCP server capabilities, OAuth, and notifications

Reviewed 2026-08-11

Topics

model-context-protocol
Stars
37★
Forks
1
Language
Go
License
Apache-2.0
Created
2025-06-12
Last push
2026-08-17