Mcp Debug
What is Mcp Debug
mcp-debug is a command-line tool designed for debugging MCP (Model Context Protocol) servers. It helps developers inspect server capabilities, debug tool integrations, and test server notifications.
Use cases
mcp-debug can be used to monitor and interact with MCP servers, perform debugging tasks effectively, integrate AI assistants, and facilitate development processes by providing detailed insights and capabilities.
How to use
To use mcp-debug, you can install it by building from source using ‘make build’. You can connect to a server for notifications, start an interactive REPL mode, or run it as an MCP server for AI integrations by executing respective commands with appropriate flags.
Key features
Key features include the ability to connect to any MCP server, an interactive REPL for exploration, operate as an MCP server for AI integrations, verbose logging for detailed debugging, self-update capability, and shell autocompletion for convenience.
Where to use
mcp-debug is ideal for developers working with MCP servers for debugging, testing, and integration purposes. It can be used in local development environments, during the integration of tools with AI assistants, and for enhancing the debugging process in server-side applications.
Overview
What is Mcp Debug
mcp-debug is a command-line tool designed for debugging MCP (Model Context Protocol) servers. It helps developers inspect server capabilities, debug tool integrations, and test server notifications.
Use cases
mcp-debug can be used to monitor and interact with MCP servers, perform debugging tasks effectively, integrate AI assistants, and facilitate development processes by providing detailed insights and capabilities.
How to use
To use mcp-debug, you can install it by building from source using ‘make build’. You can connect to a server for notifications, start an interactive REPL mode, or run it as an MCP server for AI integrations by executing respective commands with appropriate flags.
Key features
Key features include the ability to connect to any MCP server, an interactive REPL for exploration, operate as an MCP server for AI integrations, verbose logging for detailed debugging, self-update capability, and shell autocompletion for convenience.
Where to use
mcp-debug is ideal for developers working with MCP servers for debugging, testing, and integration purposes. It can be used in local development environments, during the integration of tools with AI assistants, and for enhancing the debugging process in server-side applications.
Content
MCP 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-httporssetransports. - 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, run:
make build
This will create the mcp-debug binary in the project directory.
Full Usage Guide
For detailed instructions on modes, flags, and examples, please see the full usage guide:
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.