Interminal

io.github.QiuwenZheng由 GitHub 帳號 QiuwenZheng 發布v1.0.4更新於 Oct 24, 2026

Lightweight MCP server providing terminal access (SSH & local shells) for AI assistants.

已驗證STDIO僅桌面雲端與基礎設施開發者工具

概覽

AI 產生的概覽

本機 MCP 伺服器，讓 AI 助理取得終端機存取能力，可在本機 shell 或透過 SSH 執行指令，支援互動式與長時間執行的指令。

可以做什麼
  • 連線 SSH 伺服器並建立工作階段，回傳工作階段 ID 與歡迎訊息
  • 在本機或透過 SSH 執行指令，回傳輸出，或回傳部分狀態與指令 ID
  • 輪詢執行中的指令以取得新輸出，無需送出輸入
  • 對等待提示字元的指令送出文字輸入
  • 送出控制鍵，例如 ctrl+c、ctrl+z、方向鍵與功能鍵
  • 中斷 SSH 工作階段並釋放相關資源
適用情境
適合需要助理在使用者本機或遠端主機上透過 SSH 執行 shell 指令的情境，尤其是涉及互動式提示、長時間執行的程序，或需要終端機多工器維持狀態的多步驟工作流程。
執行需求
以 stdio 方式在本機執行；需要 Python 3.11 以上版本，透過 uvx 或 pip 安裝 mcp-interminal 套件啟動。遠端主機的 SSH 存取與憑證由所執行的指令提供。選用相依套件可加入 Windows PTY 支援與 ANSI 呈現。
安裝前請注意
助理可在本機與遠端主機執行任意指令，可能變更或刪除資料，也可能啟動長時間執行的程序。每次 execute 呼叫都是獨立通道，cd 等狀態不會在呼叫之間保留。SSH 憑證透過助理執行的指令處理。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Interminal，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Interminal

Lightweight MCP server that gives AI assistants terminal access — SSH and local shells — with support for interactive and long-running commands.

Installation

bash
# Run directly, no install needed (recommended)uvx mcp-interminal
# Or install permanentlypip install mcp-interminal

Requires Python ≥ 3.11.

MCP Client Configuration

Claude Desktop (claude_desktop_config.json):

json
{  "mcpServers": {    "interminal": {      "command": "uvx",      "args": ["mcp-interminal"]    }  }}

Cursor / other clients: same command + args format above.

Tools

ToolDescription
connect_sshConnect to an SSH server; returns session_id and welcome banner
executeRun a command locally (no session needed) or over SSH; returns output or status=partial + command_id
read_outputPoll a running command for new output without sending input
respondSend text input to a command waiting at a prompt
send_controlSend control keys: ctrl+c, ctrl+z, arrow keys, F-keys, etc.
disconnectClose an SSH session and release all resources

Persistent State

Each execute call runs in an isolated channel — there is no persistent shell between calls. For simple tasks, chaining with && works.

For multi-step workflows (project development, debugging, deployment), a terminal multiplexer (like Zellij) provides persistent state that survives across calls. The AI agent can create a persistent session where cd, environment variables, virtual environments, and long-running processes carry over naturally.

Key Behaviors

  • Stateless execute — each call is an isolated channel; cd /foo does not persist. Simple tasks: chain with &&. Multi-step workflows: use a terminal multiplexer.
  • Long-running commands return status="partial" with a command_id; poll with read_output or send input with respond
  • SSH PTY is 500×200 xterm-256color so multiplexer sessions render at your actual terminal size

Optional Dependencies

bash
pip install "mcp-interminal[pty]"       # Windows PTY support (pywinpty)pip install "mcp-interminal[ansi]"      # ANSI escape rendering (pyte)pip install "mcp-interminal[pty,ansi]"  # both

來源：README.md，提交 ed6d78d

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.4最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分