qiuwenzheng avatar

Interminal

qiuwenzheng/interminal

Gives Claude direct terminal access through seven tools: connect_ssh for remote shells, create_local for host execution, execute for running commands, and helpers for polling output, sending input, or killing processes. Long running commands return a command_id you can poll without blocking. The interesting bit is the Zellij integration. Without a multiplexer, each execute call is isolated and stateless. Install Zellij on the target machine and the AI automatically gets persistent sessions where cd, environment variables, and background processes stick around between calls. You can even attach to watch Claude work in real time. Ships as a uvx one liner, supports interactive prompts and control sequences.

GitHub stars
2
tools
6
transport
STDIO
last updated
May 28, 2026

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

connect_sshConnect to an SSH server; returns session_id and welcome banner.

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

No parameter schema in public metadata yet.

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

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

No parameter schema in public metadata yet.

read_outputPoll a running command for new output without sending input.

Poll a running command for new output without sending input.

No parameter schema in public metadata yet.

respondSend text input to a command waiting at a prompt.

Send text input to a command waiting at a prompt.

No parameter schema in public metadata yet.

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

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

No parameter schema in public metadata yet.

disconnectClose an SSH session and release all resources.

Close an SSH session and release all resources.

No parameter schema in public metadata yet.

Sponsors

Readme

Interminal

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

Installation

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

# Or install permanently
pip install mcp-interminal

Requires Python ≥ 3.11.

MCP Client Configuration

Claude Desktop (claude_desktop_config.json):

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

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

Tools


View the full README on GitHub

Details

Repository
github.com/qiuwenzheng/interminal
Category
Developer Tools
Package
mcp-interminal
Transport
STDIO
Registry
MCP registry, active

Related Developer Tools MCP servers

View all
1rbfinch avatarHindsight MCPrbfinch/hindsight-mcpMCP server for AI-assisted coding with development history: git, tests, Copilot.2stars
2pkobielak avatarSuperpowers.socialpkobielak/social-superpowers-mcpLive X/Twitter and Reddit research. 10 read-only MCP tools, Google/GitHub sign-in. Free tier.2stars
3andysalvo avatarAgentic Platformandysalvo/agentic-platformFree MCP tools: the only MCP linter, health checks, cost estimation, and trust evaluation.1stars
4cookyecat avatarStarmux — All-in-One Self-Hosted Remote MCP Server & Gatewaycookyecat/starmuxAll-in-one remote MCP server & gateway: built-in file, terminal, process & stdio tools over HTTP.1stars
5ctrlpi avatarPi Bayctrlpi/pi-bayApp and MCP server for Raspberry Pis and SSH devices on a LAN: files, terminal, ctrlPi API install.1stars
6frankxmx avatarDailyhotmcpfrankxmx/dailyhotmcp聚合55+平台热门榜单数据的AI工具,支持微博、知乎、B站、GitHub等平台。适用于LLM/RAG场景。1stars