@c0dingbear/termius-mcp

中文文档
0.6.2发布于 2026/11/07MITCommonJS近 30 天下载 2136

连接代理到您的 Termius 机器的 MCP 服务器: 具有本地 GUI 批准对话框的符号授权 SSH 隧道, 持续的 shell/ exec, 背景任务, 以及 SFTP 文件传输 。 包括 termius-mcp setup 用于自动检测和配置代理.

中文使用文档
文档目录4 节
  1. 安装配置( S)
  2. 手动 MCP 客户端配置
  3. 添加您的代理
  4. 许可证

@ c0dingbear/ termius- mcp

一个 MCP 服务器 让特工连接到您保存的机器 特米乌斯 保险库 - 安全.

  • 本地图形用户界面批准: 每一个连接都会在您的计算机上弹出一个对话框 (Allow / 允许开会/拒绝),通过 @c0dingbear/access-prompt。 。 。 . "请为这届"薄荷酒 consentToken 这样代理可以重新连接到 那台机器在电脑重启前没有重现.
  • 托肯授权的SSH隧道 (前出/倒出),通过跳出-宿主链.
  • 执行: 一发(termius_tunnel_exec后退)和a 持久交互式外壳( e)termius_session_exec) (中文(简体) ).
  • 背景任务: 开始 / 检查 / 杀死长期运行的命令 .
  • SFTP 系统数字 : termius_sftp_write (仅书写), read, (中文(简体) ), upload, (中文(简体) ), download, (中文(简体) ), list ——特工停止通过基地64回声走私文件.
  • 耐受性: 保持连接, 空投隧道被标记为已死 发出明确信息,告诉代理商重新连接(而不是赤裸的) "不相通").

主机发现/解密来自 @c0dingbear/termius-vault。 。 。 .

安装配置( S)

npm install -g @c0dingbear/termius-mcp
termius-mcp setup        # detect your agents and add the MCP config

termius-mcp setup 发现安装的代理 - 打开码 克洛德码 克洛德码 桌面、 Cursor、 Pi、 Codex、 Windsurf、 Cline、 Zed、 继续、 反重力、 Amazon Q、 Kilo 代码、 VS 代码 ——并提议将服务器添加到每个服务器中(合并到 已存在的配置,首先支持它,并具有一能性). 旗帜 : --yes (非互动), --print (只是显示手动片段).

在一个 全球 安装安装器也会自动运行此程序 若为 这是 互动 10秒后自动滑行 绝不编辑配置 没有明确的"是"。 非交互/ CI 安装只是打印提示 。 所以说 有两件事你总是需要: 已安装的软件包 && 你的经纪人 配置 (单位:千美元) setup 步骤是第二步.

直接运行服务器( 代理发射内容) :

termius-mcp              # speaks MCP over stdio

手动 MCP 客户端配置

{
  "mcp": {
    "termius": {
      "type": "local",
      "command": ["termius-mcp"],
      "environment": { "DISPLAY": ":0" }
    }
  }
}

DISPLAY (Linux) 必须指向您的桌面会话, 这样批准对话框就可以 出现。 需要安装和登录 Termius 桌面应用程序 .

添加您的代理

名单里没看到你的经纪人吗? 加上一个是小的,自成一体 变动- 编辑 setup.js 打开 PR。 。 。 .

每一个代理都是一个条目 agents() 列表: a detected 检查( 检查其 配置文件 / CLI 存在吗 ?) and an apply() 将服务器合并到其配置 (退后,如果它已经在那里,就不要) 大多数特工都使用常用的 mcpServers JSON形状,所以可以复制像Cursor一样已存在的块:

// My Agent — ~/.myagent/mcp.json, mcpServers shape
{
  const file = path.join(os.homedir(), ".myagent", "mcp.json");
  list.push({
    id: "myagent", label: "My Agent", target: file,
    detected: fs.existsSync(file) || hasCommand("myagent"),
    apply() {
      const cfg = readJsonSafe(file) || {};
      cfg.mcpServers = cfg.mcpServers || {};
      if (cfg.mcpServers.termius) return { status: "exists", detail: file };
      cfg.mcpServers.termius = genericEntry();   // { command: "termius-mcp", env?: { DISPLAY } }
      writeJson(file, cfg);
      return { status: "added", detail: file };
    }
  });
}

对于不同的方案(类似于 Codex 的 TOML, a) context_servers编号 :servers 键,或 a YAML 块文件,参见 Codex, Zed, VS 代码和图案的继续条目.

许可证

麻省理工学院

版本与发布记录

@c0dingbear/termius-mcp 共发布 11 个版本,首次发布于 2026/10/23;过去 12 个月发布了 11 个版本。

版本发布日期距今
0.6.2latest2026/11/071 天前
0.6.12026/11/071 天前
0.6.02026/11/071 天前
0.5.02026/11/071 天前
0.4.02026/11/071 天前
0.3.22026/10/309 天前

关于 @c0dingbear/termius-mcp 的常见问题

@c0dingbear/termius-mcp 是什么?

连接代理到您的 Termius 机器的 MCP 服务器: 具有本地 GUI 批准对话框的符号授权 SSH 隧道, 持续的 shell/ exec, 背景任务, 以及 SFTP 文件传输 。 包括 termius-mcp setup 用于自动检测和配置代理.

如何安装 @c0dingbear/termius-mcp?

在项目目录运行 npm install @c0dingbear/termius-mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 termius-mcp,可以用 npx termius-mcp 直接运行。

@c0dingbear/termius-mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/c0dingbear__termius-mcp 是否存在。

@c0dingbear/termius-mcp 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@c0dingbear/termius-mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=16。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@c0dingbear/termius-mcp 可以商用吗?

@c0dingbear/termius-mcp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@c0dingbear/termius-mcp 的下载量有多少?

根据 npm 官方下载统计,@c0dingbear/termius-mcp 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,136 次,日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@c0dingbear/termius-mcp 还在维护吗?

最新版本 0.6.2 发布于 2026/11/07(1 天前);至今共发布 11 个版本,其中过去 12 个月发布了 11 个;首次发布于 2026/10/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。