简介
最近在用算能板卡宇宙 (Bianbu Cloud) 的 RISC-V 云主机做开发，SSH 配置搞来搞去比较烦，于是写了这个 Tabby 终端插件。
tabby-bianbu-mcp 基于 MCP (Model Context Protocol) 协议，让你在 Tabby 终端里直接连上算能云主机，不需要配 SSH 密钥、不需要 SFTP 工具，填个域名和 API Key 就能用。
核心能力：
- 真正的 PTY 终端（全彩色、支持 vim / htop / claude 等交互式程序）
- 内置文件管理器（浏览、上传、下载、在线编辑）
- Shell 命令执行
- 一键远程服务端升级（蓝绿部署 + 自动回滚）
当前版本：插件 v0.9.3 / 服务端脚本 v1.6.0
GitHub: https://github.com/niver2002/tabby-bianbu-mcp
---
环境要求
┌────────────┬────────────────────────────────────────────────────────┐
│ 项目 │ 要求 │
├────────────┼────────────────────────────────────────────────────────┤
│ Tabby 终端 │ 从 https://tabby.sh 下载，支持 Windows / macOS / Linux │
├────────────┼────────────────────────────────────────────────────────┤
│ Node.js │ 云主机端需要（bootstrap 脚本会自动安装） │
├────────────┼────────────────────────────────────────────────────────┤
│ 算能云账号 │ 需要有 API Key 和已开通的云主机实例 │
└────────────┴────────────────────────────────────────────────────────┘
---
快速上手：三步搞定
第一步：安装插件
打开 Tabby → 设置 → 插件 → 搜索 tabby-bianbu-mcp → 点击 安装。
也可以通过命令行安装：
npm install tabby-bianbu-mcp
安装完成后重启 Tabby。
[截图: Tabby 插件市场搜索 tabby-bianbu-mcp 并安装]
第二步：部署服务端
SSH 登录你的算能云主机，执行以下命令：
wget https://github.com/niver2002/tabby-bianbu-mcp/releases/latest/download/bianbu_agent_proxy.sh
chmod +x bianbu_agent_proxy.sh
sudo ./bianbu_agent_proxy.sh bootstrap
这个脚本会自动完成：
1. 创建 bianbu 系统用户
2. 安装 Node.js（如果没有）
3. 部署 MCP 服务到 /opt/bianbu-mcp-server/
4. 注册并启动 systemd 服务
5. 在 0.0.0.0:11434 端口监听
验证服务是否正常运行：
curl http://127.0.0.1:11434/health
看到 "ok": true 就说明没问题了。
[截图: SSH 终端中执行 bootstrap 命令和 health 检查结果]
第三步：配置连接
1. 登录 https://cloud.bianbu.org，点击右上角头像 → 侧栏 API Key，复制密钥
2. 在控制台首页，点击实例卡片上的 "开始远程"，找到类似 xxx.gdriscv.com 的域名
3. 打开 Tabby → 设置 → Bianbu MCP，填入：
┌─────────┬─────────────────────────────────┬─────────────────┐
│ 字段 │ 说明 │ 示例 │
├─────────┼─────────────────────────────────┼─────────────────┤
│ Domain │ 只填域名，不含 https:// 和 /mcp │ xxx.gdriscv.com │
├─────────┼─────────────────────────────────┼─────────────────┤
│ API Key │ 控制台复制的完整密钥 │ your-api-key │
├─────────┼─────────────────────────────────┼─────────────────┤
│ Name │ 显示名称，随便填 │ 我的算能主机 │
└─────────┴─────────────────────────────────┴─────────────────┘
4. 点击 "Test connection" 验证连接
5. 连接成功后：
- 点击 "Open Shell" 打开终端
- 点击 "Open Files" 打开文件管理器
[截图: Tabby 设置页面中 Bianbu MCP 配置界面]
[截图: 成功连接后的 Shell 终端界面]
---
功能亮点
PTY 终端
真正的伪终端，不是简单的命令执行。支持全彩色输出、vim 编辑、htop 监控等交互式程序。插件会自动检测远端是否支持 PTY，不支持时自动回退到普通 Shell 模式。
[截图: PTY 终端中运行 vim 或 htop 的效果]
文件管理器
Windows 11 Fluent 风格暗色主题的文件管理器，功能完整：
- 浏览、新建、重命名、删除文件和目录
- 拖拽上传文件
- 内联文本编辑器，在线编辑保存
- 点击列头排序（名称 / 大小 / 修改时间 / 类型）
- Ctrl+Click 多选，Shift+Click 范围选择
- 常用快捷键：F2 重命名 / F5 刷新 / Del 删除 / Ctrl+N 新文件 / Ctrl+Shift+N 新文件夹
[截图: 文件管理器界面，展示文件列表和操作工具栏]
一键远程升级
在 Tabby 设置页直接推送升级远端服务，不用再 SSH 上去手动操作。
- 蓝绿部署：新版本在临时目录准备好后原子切换
- 自动回滚：部署失败时自动恢复之前的版本
- 进度 UI：分步进度条 + 计时器 + 取消按钮
[截图: Push Upgrade 进度条界面]
MCP 配置片段
设置页自动生成 JSON 配置，可以直接复制给其他 MCP 客户端（如 Claude Desktop）使用：
{
"mcpServers": {
"bianbu": {
"type": "http",
"url": "https://your-domain.example.com/mcp",
"headers": {
"X-API-KEY": "your-api-key"
}
}
}
}
---
常见问题
┌──────────────────────────────────┬─────────────────────────────────────────────────────────────────────┐
│ 问题 │ 解决方案 │
├──────────────────────────────────┼─────────────────────────────────────────────────────────────────────┤
│ connect ECONNREFUSED │ MCP 服务未运行。SSH 登录执行 sudo ./bianbu_agent_proxy.sh bootstrap │
├──────────────────────────────────┼─────────────────────────────────────────────────────────────────────┤
│ Push Upgrade 在 wait 步骤超时 │ SSH 登录查看日志：cat /tmp/bianbu_agent_proxy.sh.log │
├──────────────────────────────────┼─────────────────────────────────────────────────────────────────────┤
│ Shell 能用但没有颜色、不能用 vim │ 远端服务器版本过低，使用 Push Upgrade 更新即可 │
├──────────────────────────────────┼─────────────────────────────────────────────────────────────────────┤
│ 服务彻底挂了 │ SSH 登录执行 sudo ./bianbu_agent_proxy.sh bootstrap 重新安装 │
└──────────────────────────────────┴─────────────────────────────────────────────────────────────────────┘
---
安全提示
- 始终使用 HTTPS 连接，HTTP 会明文传输 API Key
- 设置页的 MCP 配置片段包含真实 API Key，不要截图公开分享
---
相关链接
- GitHub 仓库: https://github.com/niver2002/tabby-bianbu-mcp
- npm 包: https://www.npmjs.com/package/tabby-bianbu-mcp
- Tabby 终端: https://tabby.sh
- 算能板卡宇宙: https://cloud.bianbu.org
- 问题反馈: https://github.com/niver2002/tabby-bianbu-mcp/issues
---
开源协议：MIT
如果觉得有用，欢迎去 GitHub 点个 Star，有问题直接提 Issue。`预先格式化的文本`