MCP Catalogs
← Home

mcp-debug

by giantswarm·★ 37·Score 46

A command-line tool for debugging MCP servers with OAuth 2.1 authentication, interactive REPL, and server mode.

developer-toolsai-llmsecurity
1
Forks
2
Open issues
this month
Last commit
2d ago
Indexed

Overview

mcp-debug is a comprehensive Go-based tool designed to help developers work with MCP servers. It provides an interactive REPL for exploring available tools, resources, and prompts, making it easy to test server functionality. The tool supports OAuth 2.1 authentication with automatic discovery, PKCE validation, and dynamic client registration, meeting the latest MCP specification requirements. Additionally, it can act as an MCP server itself, enabling integration with AI assistants like Cursor.

Try asking AI

After installing, here are 3 things you can ask your AI assistant:

you:Debugging tool integrations in MCP servers by inspecting capabilities and testing tool calls
you:Testing MCP server notifications and responses with detailed JSON-RPC logging
you:Authenticating to OAuth-protected MCP servers with automatic discovery and PKCE validation

When to choose this

Choose mcp-debug when you need a dedicated debugging tool for MCP servers with comprehensive OAuth 2.1 support and detailed JSON-RPC message logging.

When NOT to choose this

Don't choose mcp-debug if you need support for non-HTTP transports, as it only works with `streamable-http` protocol MCP servers.

Comparable tools

mcp-climcp-server-gomcp-server-rust

Installation

Installation

From Source

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

Usage

# Connect to an MCP server
./mcp-debug --endpoint http://localhost:8090/mcp

# Start interactive REPL
./mcp-debug --repl

# Run as MCP server
./mcp-debug --mcp-server

# OAuth authentication
./mcp-debug --oauth --endpoint https://mcp.example.com/mcp

Claude Desktop Integration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-debug": {
      "command": "mcp-debug",
      "args": ["--mcp-server"]
    }
  }
}

Compare mcp-debug with

mcp-debug vs ultimate_mcp_servermcp-debug vs mcp-server-chartmcp-debug vs everythingmcp-debug vs filesystemmcp-debug vs time
GitHub →

Last updated · Auto-generated from public README + GitHub signals.