优秀远程指挥官(BRC)
使用你现有的AI聊天访问在你自己的电脑上工作。BRC将支持远程MCP(模型上下文协议)的聊天客户端连接到自托管中继。您可以管理文件,运行终端命令,并从对话中检查进程。
免费聊天额度,比如ChatGPT的免费层,以及与编码代理配额分离的聊天额度,比如Gemini生态系统中的那些,都是有用的资源。当客户端支持远程MCP工具时,BRC可以使兼容的聊天访问工作。连接器访问取决于平台和计划。
基于 shahidx0x / better-remote-commander.
要求
- Windows x64(在Windows 11上测试)。
- Node.js 22.13或更新版本和pnpm。
- 聊天客户端可访问的HTTPS端点,用于远程访问。将公共入口点连接到本地Traefik代理。
BRC在本地运行Relay、Traefik和Agent。您单独管理公共HTTPS入口点。
安装
按顺序在PowerShell中运行这些命令。
1. 使用pnpm安装BRC。
pnpm add -g @inoceanlee/brc
2. BRC进行初始化。
brc setup
输入管理员用户名(默认为: admin)和至少8个字符的密码。安装程序创建本地配置并安装Traefik。
3. 设置公共URL 用于远程MCP访问。
brc config set services.publicUrl https://your-domain.example
将您的HTTPS入口点指向本地Traefik代理 127.0.0.1:13001. URL必须是源,没有 /mcp.
4. 启动BRC,检查BRC状态。
brc start
brc status
第一次启动时,使用输出或中显示的代码和设备验证页面对Agent进行配对 brc logs agent. 然后添加 https://your-domain.example/mcp 作为兼容聊天客户端的远程MCP服务器,如ChatGPT或Claude,如果您的计划支持的话。
常用命令
| 命令 | 目的 |
|---|---|
brc help | 显示命令 |
brc start | 启动Relay、Traefik和Agent |
brc stop | 停止所有托管服务 |
brc restart | 重新启动托管服务 |
brc status | 检查服务状态 |
brc logs [relay|agent|traefik] | 读取业务日志 |
brc config show | 显示有效设置 |
brc config get <key> | 阅读设置 |
brc config set <key> <value> | 更改设置 |
brc config apply | 将更改应用到YAML文件 |
brc config path | 显示配置文件路径 |
brc update traefik | 更新Traefik |
brc clean | 清理临时运行时数据 |
升级BRC包,执行命令 pnpm up -g @inoceanlee/brc --latest.
配置和数据
下存储其配置和运行时数据 %LOCALAPPDATA%\BRC\ 在Windows上。
- 配置:
%LOCALAPPDATA%\BRC\config\brc.yaml - “Data”、“Traefik”文件、“运行状态”和“日志”:“。”的子目录
%LOCALAPPDATA%\BRC\
集 BRC_DATA_ROOT 使用不同的根目录。运行 brc config path 或者 brc config show 查找文件并检查当前设置。
卸载
按顺序运行这些步骤。
1. 卸载BRC的服务和私人数据。
brc uninstall
根据提示确认显示的数据目录。这将停止托管服务并删除其私有目录中的BRC配置、凭据、数据库、Traefik文件、日志和其他数据。
2. 删除所有剩余的全局pnpm包。
pnpm remove -g @inoceanlee/brc
brc uninstall 目前还在Windows上调度命令行退出后自动删除pnpm包。等待删除完成后再运行第二个命令;它通常已经完成了。
要删除包,同时保留BRC存储的数据,只运行 pnpm remove -g @inoceanlee/brc. 公共HTTPS入口点(如Tailscale Funnel)仍然由您单独管理。
发展和贡献
git clone https://github.com/inoceanlee/better-remote-commander.git
cd better-remote-commander
pnpm install
pnpm build
pnpm test
在这个存储库中欢迎发布和拉取请求。源代码使用带有独立CLI、Relay、Agent和共享包的pnpm工作区。看到 体系结构 有关实现细节。