← 返回目录

Reloaderoo

社区

强大的MCP调试代理和CLI检查工具

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 38 / 438
Stars: ★ 125 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 无需凭据
许可证: MIT
最近提交: 8 个月前 ⚠
工具数: 9

66FMRS · C

Reloaderoo为MCP开发者提供了便捷的调试和热重载功能，CLI模式特别适合AI代理使用，代理模式能够无缝集成到开发工作流中。

最强项 · 文档质量 16/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

12/20

维护活跃度

14/20

文档质量

16/20

安装易用性

15/20

查看各项评分依据

可靠性 9/20: 源码中包含了单元测试、集成测试和端到端测试的配置（package.json 中的 test 脚本和测试目录），并且有 CI 工作流（.github/workflows）来运行这些测试。但由于没有执行这些测试，且文档未提供测试覆盖率的细节，对关键路径的可靠性评估只能基于代码结构和测试文件的存在性。因此给予 9 分。
安全与权限 12/20: 该工具作为 MCP 代理，会暴露 restart_server 工具，允许客户端重启子进程，这属于远程命令执行风险，但文档中未提及任何确认机制或权限控制。代码中未见明显的恶意行为或凭据窃取，但缺乏对敏感操作的安全审计。安全分数为 12。
维护活跃度 14/20: 仓库显示有活跃的提交记录，但版本发布历史未在静态审查中提供。依赖更新情况不明确，且未提供安全响应渠道。存在 MIT 许可证。维护性分数为 14。
文档质量 16/20: README 提供了详细的安装、CLI 命令、代理模式、配置、故障排除和集成示例，覆盖了主要场景。但文档中未提及工具的局限性（如 CLI 模式不支持有状态服务器）已在常见问题中提及，但缺少贡献指南和测试文档的链接（虽有但未验证）。文档质量良好，给予 16 分。
安装易用性 15/20: 安装简单（npm 安装或 npx），提供了客户端配置示例，支持主流平台（Windows、macOS 支持，Linux 未测试但可能可用）。文档说明了如何在不同客户端中使用。静态审查无法验证实际运行效果，但基于清晰的步骤，给予 15 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件执行命令或代码

适合谁

开发者
AI代理
CI/CD管道

不适合谁

生产环境使用
有状态服务器的测试（CLI模式）

所需权限

需要访问文件系统以启动子进程
需要网络通信的能力用于代理模式

风险与副作用

代理模式可能增加攻击面，需要确保网络环境安全
CLI模式对有状态服务器不适用，可能导致状态丢失

安装接入

准备工作

运行环境：Node.js 18+

其他可选配置项（8 个）

MCPDEV_PROXY_LOG_LEVEL 可选设置代理日志级别（debug 至 critical），无需获取，直接按需导出设置即可。

MCPDEV_PROXY_LOG_FILE 可选自定义日志文件路径，默认输出到 stderr。

MCPDEV_PROXY_DEBUG_MODE 可选设为 true 启用调试模式，输出详细日志。

MCPDEV_PROXY_RESTART_LIMIT 可选最大重启尝试次数（0-10，默认 3）。

MCPDEV_PROXY_AUTO_RESTART 可选设为 true/false 控制崩溃时是否自动重启。

MCPDEV_PROXY_TIMEOUT 可选操作超时时间（毫秒）。

MCPDEV_PROXY_RESTART_DELAY 可选两次重启尝试之间的延迟（毫秒）。

MCPDEV_PROXY_CWD 可选子进程默认工作目录。

使用npm全局安装：npm install -g reloaderoo，或使用npx运行：npx reloaderoo --help

.cursor/mcp.json

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

以 Cursor 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

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

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

通过 reloaderoo proxy -- node my-dev-server.js 启动代理并在客户端配置后，客户端的工具列表中应出现 restart_server 工具；也可先运行 reloaderoo inspect ping -- node my-dev-server.js 确认连接正常。

常见排障

无法启动服务器：检查子进程命令是否正确
连接问题：使用--log-level debug开启调试日志
CLI命令失败：先运行`reloaderoo inspect ping`测试基础连接

试试这样问

连接成功后，可以直接对 AI 助手这样说：

请重启 MCP 服务器以加载我的最新更改
列出我开发服务器上所有可用的工具
调用 echo 工具并传入参数 {"message":"hello"}
检查一下我的 MCP 服务器是否在线

工具能力 9

restart_server 写入

重启MCP服务器进程，用于加载代码更改

list_tools 只读

列出服务器上所有可用的工具

call_tool 写入

调用指定的工具并返回结果

list_resources 只读

列出所有可用的资源

read_resource 只读

读取指定资源的内容

list_prompts 只读

列出所有可用的提示词

get_prompt 只读

获取指定提示词的详细信息

get_server_info 只读

获取服务器信息和能力

展开其余 1 个工具

ping 只读

测试服务器连接性

使用场景

测试和调试MCP服务器，无需配置MCP客户端

在开发过程中热重载MCP服务器，保持AI会话不中断

通过CLI命令快速调用工具和检查服务器状态

集成到CI/CD流程中，自动化测试MCP服务器

支持客户端

VS Code

Cursor

Claude Code部分支持

Windsurf部分支持

依据项目文档列出，未经本站实测。

详细介绍

Reloaderoo是一个双模式MCP开发工具，既可以作为CLI检查工具，也可以作为透明代理服务器。它支持热重载MCP服务器，无需断开AI客户端连接，并提供了丰富的CLI命令用于直接检查和测试MCP服务器。