# io.github.iTophua/iterminal (npm · iterminal-mcp-server)

MCP Server for iTerminal SSH Connection Manager - Control SSH servers through Claude.

- Trust score: 74/100 (medium)
- Change this week: +28
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `iterminal-mcp-server`: 74/100 (this document), [markdown](https://verifymcp.io/servers/itophua-iterminal/iterminal-mcp-server.md), [page](https://verifymcp.io/servers/itophua-iterminal/iterminal-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `iterminal-mcp-server`
- Version: `2.0.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to iTophua/iterminal).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 24 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 71/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 1543 tokens (~59/item across 26 items; 26 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add itophua-iterminal -- npx -y iterminal-mcp-server
```

### Codex

```bash
codex mcp add itophua-iterminal -- npx -y iterminal-mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "itophua-iterminal": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "iterminal-mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add itophua-iterminal --command npx --arg -y --arg iterminal-mcp-server
```

### Hermes

```yaml
mcp_servers:
  itophua-iterminal:
    command: "npx"
    args: ["-y", "iterminal-mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "itophua-iterminal": {
      "command": "npx",
      "args": [
        "-y",
        "iterminal-mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 74, +25)

- [security improvement] Provenance: unverified → pass
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security] The attested source repository moved: iTophua/iterminal
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional] Licence: MIT

### 2026-08-02 (score 49, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-08-01 (score 34, +13)

- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → good

### 2026-07-31 (score 21, −25)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 46)

First indexed and scored.

## MCP tools (26)

### `iter_status` (~17 tokens)

检查 iTerminal API 服务状态

### `iter_connect` (~97 tokens)

创建 SSH 连接。参数: id(唯一标识), host(主机地址), port(端口,默认22), username(用户名), password(密码)

Input parameters:

- `host` (string, required): 服务器地址
- `id` (string, required): 连接唯一标识符
- `password` (string, required): 密码
- `port` (number): SSH端口,默认22
- `username` (string, required): 用户名

### `iter_disconnect` (~35 tokens)

断开 SSH 连接。参数: id(连接标识)

Input parameters:

- `id` (string, required): 连接标识符

### `iter_test_connection` (~74 tokens)

测试 SSH 连接是否可用(不保持连接)。参数: host, port, username, password

Input parameters:

- `host` (string, required): 服务器地址
- `password` (string, required): 密码
- `port` (number): SSH端口,默认22
- `username` (string, required): 用户名

### `iter_list_connections` (~21 tokens)

列出当前所有活跃的 SSH 连接

### `iter_exec` (~56 tokens)

在远程服务器执行命令。参数: id(连接标识), command(要执行的命令)

Input parameters:

- `command` (string, required): 要执行的命令
- `id` (string, required): 连接标识符

### `iter_monitor` (~45 tokens)

获取远程服务器系统监控数据(CPU/内存/磁盘)。参数: id(连接标识)

Input parameters:

- `id` (string, required): 连接标识符

### `iter_list_dir` (~54 tokens)

列出远程目录内容。参数: id(连接标识), path(目录路径,默认/)

Input parameters:

- `id` (string, required): 连接标识符
- `path` (string): 目录路径

### `iter_mkdir` (~53 tokens)

在远程服务器创建目录。参数: id(连接标识), path(目录路径)

Input parameters:

- `id` (string, required): 连接标识符
- `path` (string, required): 要创建的目录路径

### `iter_rm` (~50 tokens)

删除远程文件。参数: id(连接标识), path(文件路径)

Input parameters:

- `id` (string, required): 连接标识符
- `path` (string, required): 要删除的文件路径

### `iter_rename` (~70 tokens)

重命名远程文件或目录。参数: id(连接标识), old_path(原路径), new_path(新路径)

Input parameters:

- `id` (string, required): 连接标识符
- `new_path` (string, required): 新路径
- `old_path` (string, required): 原路径

### `iter_read_file` (~83 tokens)

读取远程文件内容。参数: id(连接标识), path(文件路径), max_size(最大字节数,默认1MB)

Input parameters:

- `id` (string, required): 连接标识符
- `max_size` (number): 最大读取字节数,默认1048576(1MB)
- `path` (string, required): 文件路径

### `iter_write_file` (~64 tokens)

写入远程文件内容。参数: id(连接标识), path(文件路径), content(文件内容)

Input parameters:

- `content` (string, required): 文件内容
- `id` (string, required): 连接标识符
- `path` (string, required): 文件路径

### `iter_upload_file` (~79 tokens)

上传本地文件到远程服务器。参数: id(连接标识), local_path(本地文件路径), remote_path(远程目标路径)

Input parameters:

- `id` (string, required): 连接标识符
- `local_path` (string, required): 本地文件路径
- `remote_path` (string, required): 远程目标路径

### `iter_download_file` (~80 tokens)

从远程服务器下载文件到本地。参数: id(连接标识), remote_path(远程文件路径), local_path(本地保存路径)

Input parameters:

- `id` (string, required): 连接标识符
- `local_path` (string, required): 本地保存路径
- `remote_path` (string, required): 远程文件路径

### `iter_list_saved_connections` (~27 tokens)

列出数据库中保存的所有 SSH 连接配置（不包含密码）

### `iter_quick_connect` (~41 tokens)

使用保存的连接配置快速建立 SSH 连接。参数: id(保存的连接ID)

Input parameters:

- `id` (string, required): 保存的连接ID

### `iter_network_stats` (~38 tokens)

获取远程服务器网络接口统计信息。参数: id(连接标识)

Input parameters:

- `id` (string, required): 连接标识符

### `iter_list_processes` (~43 tokens)

获取远程服务器进程列表（按内存排序）。参数: id(连接标识)

Input parameters:

- `id` (string, required): 连接标识符

### `iter_kill_process` (~60 tokens)

终止远程服务器上的进程。参数: id(连接标识), pid(进程ID)

Input parameters:

- `id` (string, required): 连接标识符
- `pid` (number, required): 要终止的进程ID

### `iter_compress` (~89 tokens)

压缩远程服务器上的文件或目录。参数: id(连接标识), source_path(源路径), target_path(目标压缩文件路径)

Input parameters:

- `id` (string, required): 连接标识符
- `source_path` (string, required): 要压缩的文件或目录路径
- `target_path` (string, required): 压缩后的目标文件路径(.tar.gz)

### `iter_extract` (~77 tokens)

解压远程服务器上的压缩文件。参数: id(连接标识), file_path(压缩文件路径), target_dir(目标目录)

Input parameters:

- `file_path` (string, required): 压缩文件路径
- `id` (string, required): 连接标识符
- `target_dir` (string, required): 解压目标目录

### `iter_search_files` (~101 tokens)

在远程服务器上搜索文件。参数: id(连接标识), path(搜索起始路径), pattern(搜索模式), max_results(最大结果数,默认100)

Input parameters:

- `id` (string, required): 连接标识符
- `max_results` (number): 最大返回结果数,默认100
- `path` (string, required): 搜索起始路径
- `pattern` (string, required): 搜索模式(支持通配符)

### `iter_upload_folder` (~82 tokens)

上传本地文件夹到远程服务器。参数: id(连接标识), local_path(本地文件夹路径), remote_path(远程目标路径)

Input parameters:

- `id` (string, required): 连接标识符
- `local_path` (string, required): 本地文件夹路径
- `remote_path` (string, required): 远程目标路径

### `iter_create_file` (~54 tokens)

在远程服务器创建空文件。参数: id(连接标识), path(文件路径)

Input parameters:

- `id` (string, required): 连接标识符
- `path` (string, required): 要创建的文件路径

### `iter_delete_directory` (~53 tokens)

删除远程服务器上的目录。参数: id(连接标识), path(目录路径)

Input parameters:

- `id` (string, required): 连接标识符
- `path` (string, required): 要删除的目录路径

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/itophua-iterminal/iterminal-mcp-server#diagnostics

## Score history

- 2026-08-03: 74
- 2026-08-02: 49
- 2026-08-01: 34
- 2026-07-31: 21
- 2026-07-30: 46
- 2026-07-28: 46
- 2026-07-27: 46

## Links

- npm package: https://www.npmjs.com/package/iterminal-mcp-server
- Socket report: https://socket.dev/npm/package/iterminal-mcp-server
- Repository: https://github.com/iTophua/iterminal
- Changelog RSS feed: https://verifymcp.io/servers/itophua-iterminal/iterminal-mcp-server/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/itophua-iterminal/iterminal-mcp-server/changelog.json
- HTML version of this page: https://verifymcp.io/servers/itophua-iterminal/iterminal-mcp-server