M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
R

Reloaderoo

Community
Powerful MCP debugging proxy and CLI inspection tool
How to install ↓ Compare GitHub source repository ↗
Category
Dev Tools #38 of 438
Stars
★ 125 Popular
Transport
stdio (local process)
Runtime
Node.js 18+
Credentials
No credential needed
License
MIT
Last commit
⚠
Tools
9
66FMRS · C

Reloaderoo provides convenient debugging and hot-reload functionality for MCP developers. CLI mode is especially suited for AI agents, and proxy mode integrates seamlessly into development workflows.

Strongest · Documentation 16/20 Weakest · Reliability 9/20

Reliability
9/20
Security and permissions
12/20
Maintenance
14/20
Documentation
16/20
Setup experience
15/20
Why each score
Reliability 9/20
The source includes unit, integration, and end-to-end test configurations (test scripts in package.json and test directories) and CI workflows (.github/workflows) to run them. However, since these tests were not executed and documentation lacks specifics on test coverage, reliability assessment is limited to code structure and test file existence. Thus, score 9.
Security and permissions 12/20
As an MCP proxy, the tool exposes a restart_server tool that allows clients to restart child processes, posing remote command execution risk, but documentation does not mention any confirmation mechanism or permission control. No obvious malicious behavior or credential theft is evident in the code, but there is a lack of security audit for sensitive operations. Security score is 12.
Maintenance 14/20
The repository shows active commit history, but release history is not provided in static review. Dependency update status is unclear, and no security response channel is offered. MIT license is present. Maintenance score is 14.
Documentation 16/20
README provides detailed installation, CLI commands, proxy mode, configuration, troubleshooting, and integration examples covering main scenarios. However, limitations (e.g., CLI mode does not support stateful servers) are mentioned in FAQ, but contribution guide and testing docs links exist but unverified. Documentation quality is good, scoring 16.
Setup experience 15/20
Installation is simple (npm or npx), client configuration examples are provided, and platform support is indicated (Windows and macOS supported, Linux untested but likely). The documentation explains how to use in various clients. Static review cannot verify actual operation, but based on clear steps, score 15.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesRuns commands or code

Best for

  • Developers
  • AI agents
  • CI/CD pipelines

Not for

  • Production environments
  • Testing stateful servers (CLI mode)

Required permissions

  • Requires filesystem access to spawn child processes
  • Requires network capability for proxy mode

Risks and side effects

  • Proxy mode may increase attack surface; ensure network security
  • CLI mode is unsuitable for stateful servers and may cause state loss

Setup

Before you start

Runtime：Node.js 18+

Other optional settings (8)
MCPDEV_PROXY_LOG_LEVEL optional Sets proxy log level (debug to critical); set it directly via export as needed.
MCPDEV_PROXY_LOG_FILE optional Custom log file path; logs go to stderr by default.
MCPDEV_PROXY_DEBUG_MODE optional Set to true to enable debug mode with verbose logging.
MCPDEV_PROXY_RESTART_LIMIT optional Maximum restart attempts (0-10, default 3).
MCPDEV_PROXY_AUTO_RESTART optional Set true/false to enable or disable auto-restart on crashes.
MCPDEV_PROXY_TIMEOUT optional Operation timeout in milliseconds.
MCPDEV_PROXY_RESTART_DELAY optional Delay between restart attempts in milliseconds.
MCPDEV_PROXY_CWD optional Default working directory for the child process.

Install globally with npm: npm install -g reloaderoo, or use with npx: npx reloaderoo --help

.cursor/mcp.json 
{
  "mcpServers": {
    "my-dev-server": {
      "command": "reloaderoo",
      "args": [
        "proxy",
        "--",
        "node",
        "my-dev-server.js"
      ]
    }
  }
}

Shown for Cursor. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "my-dev-server": {
      "command": "reloaderoo",
      "args": [
        "proxy",
        "--",
        "node",
        "my-dev-server.js"
      ]
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add my-dev-server -- reloaderoo proxy -- node my-dev-server.js

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After starting reloaderoo proxy -- node my-dev-server.js and configuring your client to connect through the proxy, the restart_server tool should appear in the client's tool list. You can also run reloaderoo inspect ping -- node my-dev-server.js to confirm connectivity.

Troubleshooting

  1. Server won't start: verify child command is correct
  2. Connection issues: use --log-level debug to enable debug logging
  3. CLI command failures: run `reloaderoo inspect ping` first to test basic connectivity

Things to try

Once connected, you can ask your AI assistant things like:

  • Please restart the MCP server to load my latest changes
  • List all available tools on my dev server
  • Call the echo tool with params {"message":"hello"}
  • Check whether my MCP server is reachable

Tools 9

restart_server writes
Restart the MCP server process to load code changes
list_tools read-only
List all available tools on the server
call_tool writes
Call a specific tool and return the result
list_resources read-only
List all available resources
read_resource read-only
Read the content of a specific resource
list_prompts read-only
List all available prompts
get_prompt read-only
Get details of a specific prompt
get_server_info read-only
Get server information and capabilities
Show 1 more tools
ping read-only
Test server connectivity

Use cases

Test and debug MCP servers without configuring an MCP client
Hot-reload MCP servers during development while keeping AI sessions intact
Quickly call tools and inspect server status via CLI commands
Integrate into CI/CD pipelines for automated testing of MCP servers

Supported clients

VS Code
Cursor
Claude CodePartial support
WindsurfPartial support

Listed from the project's documentation, not tested by this site.

Overview

Reloaderoo is a dual-mode MCP development tool that acts as both a CLI inspection tool and a transparent proxy server. It enables hot-reloading of MCP servers without disconnecting AI clients, and provides extensive CLI commands for direct inspection and testing of MCP servers.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 63.3k · Tools 2 Compare with this →
Compare with other MCP servers

Source revision 53edc55964df Data synced 2026-10-19 Read the FMRS scoring method