standardbeagle avatar

Mcp Debug

standardbeagle/mcp-debug

This is a development tool that sits between your MCP client and the servers you're building. It lets you hot-swap server binaries without restarting your client session, so you can rebuild your Go or Node server and reconnect it while keeping the same tool names active. The proxy mode aggregates multiple servers with prefixed tool names and exposes management tools like server_add, server_remove, and server_reconnect for runtime control. It records all JSON-RPC traffic to JSONL files that you can replay later for regression testing. Reach for this when you're actively developing an MCP server and want faster iteration cycles than full restarts allow, or when you need to capture real client interactions for automated testing.

tools
5
transport
STDIO
last updated
Jan 7, 2026

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

server_addAdd a server: {name: "fs", command: "npx -y @mcp/filesystem /path"}

Add a server: {name: "fs", command: "npx -y @mcp/filesystem /path"}

No parameter schema in public metadata yet.

server_removeRemove server completely

Remove server completely

No parameter schema in public metadata yet.

server_disconnectDisconnect server (tools return errors)

Disconnect server (tools return errors)

No parameter schema in public metadata yet.

server_reconnectReconnect with new command

Reconnect with new command

No parameter schema in public metadata yet.

server_listShow all servers and status

Show all servers and status

No parameter schema in public metadata yet.

Sponsors

Readme

MCP Debug

A debugging and development tool for Model Context Protocol (MCP) servers.

Go Version MCP Spec License: MIT PyPI npm

MCP Debug enables rapid development and testing of MCP servers with hot-swapping, session recording, and automated playback testing.

Features

Hot-Swap Development

  • Replace server binaries without disconnecting MCP clients
  • Add/remove servers dynamically during development
  • Tool name preservation - same interface, new implementation
  • Graceful disconnect/reconnect workflow for binary replacement

View the full README on GitHub

Details

Repository
github.com/standardbeagle/mcp-debug
Package
@standardbeagle/mcp-debug
Transport
STDIO
Registry
MCP registry, active

More from standardbeagle