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 分