mcpmon 0.1.3

Hot reload for MCP servers. Like nodemon, but for MCP.

mcpmon

Hot reload for MCP servers. Like nodemon, but for MCP.

Install

# Bun (recommended)
bunx mcpmon

# Or install globally
bun install -g mcpmon

# Python alternative
pip install mcpmon

# Or download binary from GitHub releases (no dependencies)

Usage

mcpmon --watch src/ -- python -m my_mcp_server

Options

• --watch, -w - Directory to watch (default: current directory)
• --ext, -e - File extensions to watch, comma-separated (default: py)

Examples

# Watch current directory for .py changes
mcpmon -- python server.py

# Watch src/ for .py and .json changes
mcpmon --watch src/ --ext py,json -- python -m myserver

# With crucible-mcp
mcpmon --watch src/crucible/ -- crucible-mcp

# With sage-mcp
mcpmon --watch ~/.sage/ --ext py,yaml -- sage-mcp

MCP Config

Use mcpmon in your .mcp.json for hot reload during development:

{
  "mcpServers": {
    "my-server": {
      "command": "mcpmon",
      "args": ["--watch", "src/", "--", "python", "-m", "my_server"]
    }
  }
}

How it works

1. Starts your MCP server as a subprocess
2. Watches specified directory for file changes
3. On change: SIGTERM → wait 2s → SIGKILL → restart
4. Claude Code automatically reconnects to the restarted server