# @c0dingbear/termius-mcp 中文文档

规范地址：https://npmcn.com/package/%40c0dingbear/termius-mcp/

版本：0\.6\.2
npm 元数据更新时间：2026-11-07T04:23:59.630Z
中文译文更新时间：2026-11-08T22:30:34.844Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40c0dingbear/termius-mcp
原文对照：https://npmcn.com/package/%40c0dingbear/termius-mcp/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：74.3 kB，6 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=16
- 运行依赖：4 个
- 首次发布：2026-10-23T13:36:43.910Z
- 最新版本发布：2026-11-07T04:23:59.473Z
- 近 30 天下载量：2136（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

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

## 安装

```sh
npm install @c0dingbear/termius-mcp
```

也可以使用：`pnpm add @c0dingbear/termius-mcp`、`yarn add @c0dingbear/termius-mcp`、`bun add @c0dingbear/termius-mcp`

## README

# @ c0dingbear/ termius- mcp

一个 **MCP 服务器** 让特工连接到您保存的机器 [特米乌斯](https://termius.com/) 保险库 - 安全.

-   **本地图形用户界面批准**: 每一个连接都会在您的计算机上弹出一个对话框 (Allow / 允许开会/拒绝),通过 [`@c0dingbear/access-prompt`](https://www.npmjs.com/package/@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`](https://www.npmjs.com/package/@c0dingbear/termius-vault)。 。 。 .

## 安装配置( S)

```bash
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` 步骤是第二步.

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

```bash
termius-mcp              # speaks MCP over stdio
```

### 手动 MCP 客户端配置

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

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

## 添加您的代理

名单里没看到你的经纪人吗? 加上一个是小的,自成一体 变动- [**编辑 `setup.js` 打开 PR**](https://github.com/mcg25035/termius-mcp/edit/master/setup.js)。 。 。 .

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

```js
// 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 是什么？

连接代理到您的 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 和提交记录判断。