MCP server de debug
Commit 14 nov 2026Inspecciona las capacidades de un MCP server, depura integraciones de herramientas y prueba las notificaciones del servidor mediante un REPL interactivo y un registro detallado de JSON-RPC.
También conocido como giantswarm/mcp-debug
- Stars
- 38
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 14 nov 2026
- Licencia
- Apache-2.0
¿Qué es debug MCP?
Inspecciona las capacidades de un MCP server, depura integraciones de herramientas y prueba las notificaciones del servidor mediante un REPL interactivo y un registro detallado de JSON-RPC.
Resumen generado a partir del README del proyecto
Acerca del MCP server de debug
La función principal de esta herramienta de línea de comandos es la depuración de capacidades de MCP server e integraciones de herramientas. Los desarrolladores la utilizan para inspeccionar recursos, probar notificaciones del servidor y examinar mensajes JSON-RPC mediante un registro detallado (verbose logging). Funciona con cualquier servidor que utilice el transporte streamable-http y puede actuar como un MCP server en sí mismo para integrarse con asistentes de IA como Cursor.
La seguridad se gestiona mediante el cumplimiento total de OAuth 2.1, con soporte para descubrimiento automático, validación PKCE e indicadores de recursos. Los usuarios pueden conectarse a endpoints protegidos usando el flag --oauth, que gestiona la autorización a través de un navegador y admite tanto Client ID Metadata Documents como Dynamic Client Registration. La herramienta proporciona un REPL interactivo para explorar prompts y herramientas, además de autocompletado de shell para Bash, Zsh, Fish y PowerShell.
Qué puedes hacer con él
- 1Inspeccionar capacidades del servidor de forma interactivaUsa el REPL interactivo para explorar las herramientas, recursos y prompts disponibles en un servidor conectado.
- 2Depurar comunicaciones JSON-RPCExamina logs detallados de mensajes JSON-RPC para solucionar problemas de comunicación entre el cliente y el servidor.
- 3Probar flujos de autenticación OAuth 2.1Verifica conexiones seguras a servidores protegidos mediante descubrimiento automático y validación PKCE.
- 4Integrarse con asistentes de IAEjecuta la herramienta en modo MCP server para permitir que asistentes de IA como Cursor se conecten a ella.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblegiantswarm/mcp-debug is public and reachablegithub.com/giantswarm/mcp-debug ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-11github.com/giantswarm/mcp-debug ↗Aprobado
- 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 ↗Parcial 9/15
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubMCP 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.
Preguntas sobre debug MCP
¿Cómo me conecto a un MCP server usando OAuth?
Puedes conectarte a un MCP server protegido con descubrimiento automático usando el flag --oauth y especificando el endpoint.