MCP server for unix pty control

@ianks

代码仓库

基本信息

分类

开发工具

传输方式

stdio

作者

ianks

提交者

Ian Ker-Seymer

关于 MCP server for unix pty control

The native MCP server for Unix PTY control gives AI models authentic, low-latency terminal access by spawning true pseudo-terminals—not brittle AppleScript hacks—so you can open persistent Bash, Python, or SSH sessions, run commands like “ssh prod.server,” and stream only fresh o

#terminal #shell #bash #rust

MCP server for unix pty control 配置

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

{
  "mcpServers": {
    "terminal-mcp": {
      "type": "stdio",
      "command": "terminal-mcp"
    }
  }
}

MCP server for unix pty control 工具

spawn a new terminal

run and get output immediately

start long-running commands

poll async command progress

see what's running

cleanup when done

ctrl-c and friends

概览

What is mcp server for unix pty control?

It is an MCP server that gives AI models real terminal access by spawning Unix pseudo-terminal sessions, running commands, and reading output. It is designed for developers who need native, low-latency shell interaction for AI agents.

How to use mcp server for unix pty control?

Install with cargo install --git https://github.com/ianks/terminal-mcp, then add to Claude Code using claude mcp add --scope user terminal-mcp. AI models can then call tools like create_session, execute_command, and list_sessions via JSON-RPC.

Key features of mcp server for unix pty control

True Unix ptys, not AppleScript or workarounds
Async I/O powered by Tokio
Smart buffering that only returns new output
Session persistence across tool calls
Multi-session support to run several terminals at once

Use cases of mcp server for unix pty control

AI-assisted remote server debugging via SSH
Running long-lived shell commands with async output polling
Automating multi-step development workflows (build, test, deploy)
Interactive REPL sessions (Python, bash) controlled by an agent
Switching between multiple terminal contexts in a single conversation

常见问题

What tools does the server expose?

It provides `create_session`, `execute_command`, `execute_command_async`, `read_streaming_output`, `list_sessions`, `destroy_session`, and `send_control_character`.

How does it differ from script-based terminal access?

It uses real pseudo-terminals (ptys) rather than simulated or hacked I/O, giving proper shell interaction with features like `ctrl-c`, process groups, and terminal signaling.

Can I run multiple terminals at the same time?

Yes. The server supports multi-session management, allowing you to spawn several named sessions (e.g., `bash`, `ssh`, `python`) and switch between them.

How do I run a long-running command without blocking?

Use the `execute_command_async` tool to start the command, then poll progress with `read_streaming_output` until completion. Sessions stay alive between calls.

What runtime dependencies does it require?

A Unix-like system with Rust installed (to compile via Cargo) and support for Unix ptys. The server is compiled as a native binary and communicates over MCP (stdio transport by default).

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

DocBin

Give an agent a place to put large output. Instead of returning 40k characters of a build log into the conversation, it posts the file to DocBin and hands back one short URL. Docs render with syntax highlighting and mark

Perfex CRM

themesic

Turn Perfex CRM into an AI-ready workspace. This MCP server exposes your full REST API to Claude, ChatGPT and any AI agent, so leads, invoices and tasks are one prompt away.

OrangePro

Aamir Siddiqui

OrangePro local-first CLI + MCP server for behavior mapping, grounded test generation, and dynamic proof.

Pugi

Pugi Inc.

Pugi is an AI product team that builds, checks and publishes websites and apps. Its MCP server gives agents a passive website security check graded A+ to F (headers, TLS, cookies, exposed keys in scripts), free with a no

UXMachine

UXMachine measures a web page in a real browser and returns verifiable observations, each with its evidence and its limits. It opens the address on desktop (1280×800) and mobile (390×844) and follows the site's own links