Iterminal
MCP Server for iTerminal SSH Connection Manager - Control SSH servers through Claude.
Connector by iTophua · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/itophua-iterminal
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 10 read · 8 write · 3 delete · 7 not yet classified
- Secrets
- None asked for
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 28
Read from the source code; the running server may list different tools.
Read 10 · Look things up without changing anything.
iter_extractiter_list_connectionsiter_list_diriter_list_processesiter_list_saved_connectionsiter_monitoriter_network_statsiter_read_fileiter_search_filesiter_status
Write 8 · Create, change, send or run things.
iter_create_fileiter_download_fileiter_renameiter_save_connectioniter_transfer_statusiter_upload_fileiter_upload_folderiter_write_file
Delete 3 · Delete, drop, revoke or wipe things.
iter_delete_directoryiter_kill_processiter_rm
Not yet classified 7 · We could not tell from the name and description.
iter_compressiter_connectiter_disconnectiter_execiter_mkdiriter_quick_connectiter_test_connection
Network hosts it talks to 9
api.deepseek.com· found in codeapi.openai.com· found in codeconvertio.co· found in codegithub.com· found in codeiterminal.app· found in codemyapi.service.com· found in codemydomain.dev· found in codeschema.tauri.app· found in codeurlpattern.spec.whatwg.org· found in code
Files it touches
/root/.ssh~/.ssh/id_rsa/etc/machine-id/etc/passwd/etc/shadow/home/home/user/home/user/documents/home/user/test.txt/opt/homebrew/bin/node/usr/lib/iterminal/resources/mcp-bundle/dist/index.js/usr/share/iterminal/resources/mcp-bundle/dist/index.js/var/lib/dbus/machine-id/var/log- Your home directory (~)
- Any path the agent passes to its tools
Tools (28)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
iter_compress压缩远程文件或目录为 .tar.gz(同步等待,不限时,大文件耗时久)
iter_connect创建 SSH 连接(同 host:端口:用户 已有活跃连接时自动复用,不重复握手)。已保存的配置优先用 iter_quick_connect 按名称连接
iter_create_file在远程服务器创建空文件
iter_delete_directory删除远程服务器上的目录
iter_disconnect断开 SSH 连接
iter_download_file从远程服务器下载文件到本地(后台执行,立即返回 task_id,不等传输完成)。大文件(如数百 MB 日志/备份)下载需数分钟,发起后必须用 iter_transfer_status 轮询(间隔 2-5 秒)直到 state 为 done 或 failed。不要假定调用返回即下载完成
iter_exec在远程服务器执行命令(同步等待结束,最长 60 秒;输出超 128KB 保留末尾)。查看日志用 tail -n 200 等有限条数,不要用 tail -f / journalctl -f 等持续输出命令——它们不会结束,60 秒后被强制终止(返回 timed_out: true 与超时前输出)。要看新输出就再次执行有限条数命令
iter_extract解压远程压缩文件(同步等待,不限时,大文件耗时久)
iter_kill_process终止远程服务器上的进程
iter_list_connections列出当前所有活跃的 SSH 连接
iter_list_dir列出远程目录内容(紧凑文本:类型 名称 大小 日期;权限位请用 iter_exec 执行 ls -la)
iter_list_processes获取远程进程列表(按内存排序,默认取前 20 条,可用 top 调整,最大 100)
iter_list_saved_connections列出保存的连接配置(紧凑文本:名称 user@host:端口 [分组] #标签;不含密码)。连接时用 iter_quick_connect 传名称或 IP 片段即可
iter_mkdir在远程服务器创建目录
iter_monitor获取远程服务器系统监控数据(CPU/内存/磁盘;超过 16 核时逐核占用只保留前 16)
Show 13 more tools
iter_network_stats获取远程服务器网络接口统计信息
iter_quick_connect连接已保存的配置:支持名称、完整 IP、或 IP 片段(如 11.114 匹配 172.18.11.114)。片段匹配必须唯一,多命中会列出候选
iter_read_file读取远程文件内容(默认上限 64KB,超长截断;大文件用 iter_exec 执行 tail -c / sed -n 过滤读取)
iter_rename重命名/移动远程文件或目录
iter_rm删除远程文件
iter_save_connection新建并保存 SSH 连接,可选自动连接
iter_search_files按通配符在远程搜索文件(返回完整路径与大小;默认最多 100 条)
iter_status检查 iTerminal API 服务状态
iter_test_connection测试 SSH 连通性与认证是否可用(不保持连接)
iter_transfer_status查询后台传输任务(upload/download/upload_folder 发起的)进度。返回 state(running/done/failed)、transferred 和 total(字节,total 为 0 表示未知)、error。建议每 2-5 秒轮询一次直到 done/failed
iter_upload_file上传本地文件到远程服务器(后台执行,立即返回 task_id,不等传输完成)。发起后必须用 iter_transfer_status 轮询(间隔 2-5 秒)直到 state 为 done(成功,含 bytes_transferred)或 failed(失败,含 error)。不要假定调用返回即上传完成
iter_upload_folder上传本地文件夹到远程服务器(后台执行,立即返回 task_id)。发起后用 iter_transfer_status 轮询(间隔 2-5 秒)直到 state 为 done 或 failed
iter_write_file写入远程文件内容(整文件覆盖)
Compare and alternatives
Featured in
Signals
- Stars
- 4
- Forks
- 0
- Open issues
- 0
- Last commit
- Oct 23, 2026 (5 days ago)
- Last release
- Aug 17, 2026 (2 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.iTophua/iterminal- Version
- 2.1.0
- Auth
- No auth
- Packages
- npm iterminal-mcp-server
- License
- MIT
- Repository
- github.com/iTophua/iterminal
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
Iterminal MCP server. Agent Mart. https://agentmart.dev/connectors/itophua-iterminal (last updated 2026-10-24)