interminal MCP Server

@QiuwenZheng

代码仓库

基本信息

分类

开发工具

许可证

MIT

传输方式

stdio

作者

QiuwenZheng

提交者

Zheng Qiuwen

关于 interminal MCP Server

Lightweight MCP server for SSH and local terminal access

interminal MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

interminal MCP Server 工具

Connect to an SSH server; returns `session_id` and welcome banner

Run a command locally (no session needed) or over SSH; returns output or `status=partial` + `command_id`

Poll a running command for new output without sending input

Send text input to a command waiting at a prompt

Send control keys: `ctrl+c`, `ctrl+z`, arrow keys, F-keys, etc.

Close an SSH session and release all resources

概览

What is interminal?

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

How to use interminal?

Install via pip install mcp-interminal or run directly with uvx mcp-interminal. Configure your MCP client (e.g., Claude Desktop) using the command uvx with arguments ["mcp-interminal"]. Requires Python ≥ 3.11.

Key features of interminal

SSH and local shell execution
Interactive and long-running command support
Tools: connect_ssh, execute, read_output, respond, send_control, disconnect
Optional persistent state with Zellij terminal multiplexer
Send control keys like ctrl+c, arrow keys, and F-keys
Optional Windows PTY and ANSI rendering dependencies

Use cases of interminal

AI-driven remote server management via SSH
Executing shell commands and chaining with &&
Multi-step workflows like project development and deployment
Interactive applications requiring prompt responses
Monitoring long-running commands with partial output

常见问题

How does execute handle persistent state?

Each `execute` call runs in an isolated channel; `cd` does not persist. For multi-step workflows, install Zellij on the host to provide a persistent session that carries over environment and state.

What are the optional dependencies?

Windows PTY support: `pip install mcp-interminal[pty]`. ANSI escape rendering: `pip install mcp-interminal[ansi]`. Both can be installed with `pip install mcp-interminal[pty,ansi]`.

How do long-running commands work?

They return `status="partial"` with a `command_id`. Poll for output with `read_output` or send input with `respond` while the command runs.

What runtime is required?

Python 3.11 or higher.

How are SSH connections authenticated?

The README does not detail SSH authentication; SSH credentials are provided by the user when connecting. The server communicates with the MCP client via stdio.

开发工具分类下的更多 MCP 服务器

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP

CircleCI MCP Server

CircleCI

Manage CI/CD pipelines, debug failed builds, and optimize test suites directly from your AI agents - no terminal required. The CircleCI MCP Server is a remote server hosted by CircleCI that connects AI tools and agents

Cronwatch

cronwatchdev

CronWatch records every run of your scheduled jobs in your own database, and speaks up when one is missed, fails, gets stuck, runs slow or costs too much. CronWatch is free and open-source.

LastPing

Know when your AI agents, cron jobs and CI pipelines fail, stall or go quiet. Your agent sets up monitors from a plain description, tells you what is broken and why, reads run history and traces, and writes notes on inci

Termany

thinkany-ai

Agent-Native Terminal

174