MCP.Market

Interminal MCP server

by QiuwenZheng·io.github.QiuwenZheng/interminal·v1.0.4·3 stars
No reviews yet

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

A88/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
New

3 stars

Reviews

Write one

Nobody has reviewed Interminal yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Interminal tools (8, 4 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • connect_ssh

    Establishes a persistent, stateful connection to a remote SSH server, automatically accepting host keys. This session remains active across tool calls, allowing multiple execute commands to run sequentially.

  • create_localwrite action

    Creates a persistent local terminal session (PTY on supported platforms). Starts a local shell process that remains active across tool calls.

  • disconnect

    Gracefully disconnects from an active terminal session (SSH or local) and cleans up all associated resources.

  • executewrite action

    Execute a command in a session (SSH or local). Always use this to run shell commands — there is no persistent shell between calls, so chain state-changing commands with && (e.g. "cd /foo && ls").

  • list_sessions

    List all currently active terminal sessions (SSH and local) managed by this server.

  • read_output

    Read new output from a running command without sending any input. Use this after execute returns status "partial" when the command needs no interaction (e.g. long-running build, training loop, find).

  • respondwrite action

    Send text input to a command that returned status="partial" and is waiting at a prompt. Auto-appends \ if missing.

  • send_controlwrite action

    Send a control key/signal to a running command. Use this whenever a raw control byte or escape sequence is needed — interrupting a stuck command OR driving a TUI (zellij, vim, less, htop, etc.). Prefer this over `respond` for non-printable input: many AI frameworks strip control characters from MCP string arguments, but the string-keyed enum here is always safe.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan7 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 77 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Interminal compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 75% of 48,255 servers
Tools
8
the typical server has 7
Tools that change things
50%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
3
more than 80% of 28,688 servers

What its tools let an agent do: 4 read · 1 create · 1 change · 1 send or post · 1 run or deploy

Install Interminal in Claude Code, Cursor or VS Code

claude mcp add interminal -- uvx mcp-interminal
Add to Cursor

What the publisher says

From the Interminal repository's README, as published. We do not edit it. Read it on GitHub

Interminal

<!-- mcp-name: io.github.QiuwenZheng/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 (claudedesktopconfig.json):

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

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

Tools

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 commandid; poll with readoutput or send input with respond
  • SSH PTY is 500×200 xterm-256color so multiplexer sessions render at your actual terminal size

Optional Dependencies

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

Nothing above is checked by us. What we check is on the safety report.

Interminal: common questions

Is Interminal MCP server safe?
Yes, by our scan: it is graded A (88/100). Read the Interminal safety report
How do I install Interminal?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Interminal need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Interminal maintained?
The last commit was 114 days ago (2026-07-13). The latest release is v1.0.4.
How does Interminal compare with other MCP servers?
safety score 88/100 (higher than 75% of 48,255 servers); tools 8 (the typical server has 7); tools that change things 50% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.