debug MCP server
Commit 14. Nov. 2026Überprüfe MCP server Capabilities, debugge Tool-Integrationen und teste Server-Notifications mit einem interaktiven REPL und verbose JSON-RPC Logging.
Auch bekannt als giantswarm/mcp-debug
- Stars
- 38
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 14. Nov. 2026
- Lizenz
- Apache-2.0
Was ist debug MCP?
Überprüfe MCP server Capabilities, debugge Tool-Integrationen und teste Server-Notifications mit einem interaktiven REPL und verbose JSON-RPC Logging.
Zusammenfassung generiert aus dem README des Projekts
Über debug MCP server
Das Debugging von MCP server Capabilities und Tool-Integrationen ist die Hauptfunktion dieses CLI-Tools. Entwickler nutzen es, um Resources zu inspizieren, Server-Notifications zu testen und JSON-RPC-Messages durch verbose Logging zu untersuchen. Es funktioniert mit jedem Server, der den streamable-http Transport nutzt, und kann selbst als MCP server fungieren, um sich in AI-Assistenten wie Cursor zu integrieren.
Die Sicherheit wird durch volle OAuth 2.1 Compliance gewährleistet, inklusive Unterstützung für Automatic Discovery, PKCE-Validierung und Resource Indicators. Nutzer können sich über das --oauth Flag mit geschützten Endpoints verbinden, welches die Autorisierung via Browser verwaltet und sowohl Client ID Metadata Documents als auch Dynamic Client Registration unterstützt. Das Tool bietet ein interaktives REPL zum Erkunden von Prompts und Tools sowie Shell-Autocompletion für Bash, Zsh, Fish und PowerShell.
Was du damit machen kannst
- 1Server Capabilities interaktiv inspizierenNutze das interaktive REPL, um verfügbare Tools, Resources und Prompts auf einem verbundenen Server zu erkunden.
- 2JSON-RPC Kommunikation debuggenUntersuche detaillierte JSON-RPC Message Logs, um Kommunikationsprobleme zwischen Client und Server zu beheben.
- 3OAuth 2.1 Authentication Flows testenVerifiziere sichere Verbindungen zu geschützten Servern mittels Automatic Discovery und PKCE-Validierung.
- 4Mit AI-Assistenten integrierenStarte das Tool im MCP server Mode, damit AI-Assistenten wie Cursor eine Verbindung dazu aufbauen können.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbargiantswarm/mcp-debug is public and reachablegithub.com/giantswarm/mcp-debug ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-11github.com/giantswarm/mcp-debug ↗Bestanden
- OpenSSF ScorecardOpenSSF Scorecard 5.9 / 10; weakest: Code-Review 0, Token-Permissions 0, CII-Best-Practices 0scorecard.dev/viewer/?uri=github.com/giantswarm/mcp-debug ↗Teilweise 9/15
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenMCP Debug
mcp-debug is a command-line tool for debugging MCP (Model Context Protocol) servers. It helps developers inspect MCP server capabilities, debug tool integrations, and test server notifications.
Key Features
- Connect to any MCP Server: Works with servers using
streamable-httptransport. - OAuth 2.1 Authentication: Full MCP authorization specification (2025-11-25) compliance with security-first defaults
- Automatic discovery (RFC 9728 Protected Resource Metadata, RFC 8414 AS Metadata)
- Resource Indicators (RFC 8707) for token audience binding
- PKCE validation (required by MCP spec)
- Dynamic Client Registration (RFC 7591) and Client ID Metadata Documents
- Step-up authorization for runtime permission escalation
- Intelligent scope selection (auto and manual modes)
- Interactive REPL: Explore available tools, resources, and prompts interactively.
- MCP Server Mode: Acts as an MCP server itself, allowing integration with AI assistants like Cursor.
- Verbose Logging: Detailed logging of JSON-RPC messages for in-depth debugging.
- Self-Update: Keep the tool up-to-date with a single command.
- Shell Autocompletion: Generates autocompletion scripts for Bash, Zsh, Fish, and PowerShell.
Getting Started
Installation
To build the tool from source and install it in your PATH:
go install github.com/giantswarm/mcp-debug@latest
Documentation
For detailed instructions on all features:
- ➡️ mcp-debug Usage Guide - Complete feature guide
- ➡️ OAuth 2.1 Documentation - Comprehensive OAuth authentication guide
OAuth 2.1 Quick Start
Connect to a protected MCP server with automatic discovery:
./mcp-debug --oauth --endpoint https://mcp.example.com/mcp
This automatically:
- Discovers the authorization server (RFC 9728)
- Validates PKCE support (required by MCP spec)
- Uses the official Client ID Metadata Document (CIMD)
- Falls back to Dynamic Client Registration if CIMD is not supported
- Opens your browser for authorization
- Connects with audience-bound tokens (RFC 8707)
Client ID Metadata Document (CIMD)
mcp-debug uses CIMD by default for OAuth authentication. The official client metadata is hosted at:
https://giantswarm.github.io/mcp-debug/client.json
This allows OAuth-protected MCP servers to identify mcp-debug without requiring pre-registration. The authorization server fetches the metadata from this URL and displays "MCP Debugger CLI" on the consent screen.
If you need to use a custom CIMD or disable it:
# Use a custom CIMD URL
./mcp-debug --oauth --oauth-client-id-metadata-url https://example.com/my-client.json --endpoint https://mcp.example.com/mcp
# Disable CIMD and force Dynamic Client Registration
./mcp-debug --oauth --oauth-disable-cimd --endpoint https://mcp.example.com/mcp
See the OAuth Documentation for detailed guides, examples, and troubleshooting.
Basic Examples
Connect to a server and listen for notifications:
./mcp-debug --endpoint http://localhost:8090/mcp
Start the interactive REPL:
./mcp-debug --repl
Run as an MCP server for AI assistant integration:
./mcp-debug --mcp-server
Refer to the usage guide for more advanced examples.
Contributing
Contributions are welcome! Please open an issue or submit a pull request.
License
mcp-debug is licensed under the Apache 2.0 License.
debug MCP Fragen
Wie verbinde ich mich über OAuth mit einem MCP server?
Du kannst dich mit einem geschützten MCP server und automatischer Discovery verbinden, indem du das --oauth Flag nutzt und den Endpoint angibst.