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.

「開発者ツール」の他のコンテンツ

qrp-mcp

StanimirTenev

Find quantum-vulnerable cryptography in your codebase — secp256k1, Ed25519, BLS, Schnorr, RSA. Local, offline MCP server for AI agents.

OSIR Domain Name MCP Server

Osir

Remote MCP server from OSIR, an ICANN-accredited registrar: 105 tools and 11 prompts to search, register, renew, transfer, and manage domains, DNS, VPS, email, and websites from Claude, ChatGPT, Cursor, or any MCP client

Meticulous

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott

ArtiBot Cloud MCP - Zhijiangyun 智匠云

bofob

ArtiBot Cloud MCP (Zhijiangyun 智匠云) — cloud MCP server for robot manipulation data & GPU workloads. 15 tools: robot fleet management, data collection & video recording, post-processing pipelines, and benchmark evaluation