1. Conduid
  2. Developer Tools
  3. Terminal MCP
MCP server · Developer Tools

Terminal MCP

by · github.com/ianks/terminal-mcp

native mcp server for unix pty control

Unclaimed last commit 8 months ago mcpmcp-clientrust
InstallView source
39Low

Scored 4 days ago · breakdown

About Terminal MCP

Terminal MCP is an MCP server published by ianks in the Developer Tools category: native mcp server for unix pty control.

The repository has 12 stars and 4 forks, with the last commit 8 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/ianks/terminal-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Terminal MCP

Powered by Claude · Grounded in docs

I know everything about Terminal MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository yesterday. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • !License declaredNo license file. Legally you have no right to use it in a product.
  • !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.

1 check has not been run yet.

README

terminal-mcp

native mcp server for unix pty control.

what

mcp server that gives ai models real terminal access. spawn sessions, run commands, read output. that's it.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_session",
    "arguments": {
      "session_name": "prod-debug",
      "command": "ssh prod.server"
    }
  }
}

features

  • true ptys not applescript hacks, real unix terminals
  • async everything tokio-powered non-blocking i/o
  • smart buffering only new output, no duplicates
  • session persistence terminals stay alive between calls
  • multi-session support run multiple terminals at once and switch between them

concepts

  • sessions: named terminal instances (bash, python, ssh)
  • tools: mcp protocol endpoints the ai calls
  • ptys: pseudo-terminals for proper shell interaction
  • managers: lifecycle and cleanup automation

tools

  • create_session: spawn a new terminal
  • execute_command: run and get output immediately
  • execute_command_async: start long-running commands
  • read_streaming_output: poll async command progress
  • list_sessions: see what's running
  • destroy_session: cleanup when done
  • send_control_character: ctrl-c and friends

config

claude code:

cargo install --git https://github.com/ianks/terminal-mcp
claude mcp add --scope user terminal-mcp

dev

cargo test -- --nocapture           # see test output
RUST_LOG=debug cargo run            # verbose logging
cargo clippy                        # lint
cargo fmt                           # format

architecture

mcp api layer (json-rpc)
    ↓
session manager (lifecycle)
    ↓
pty engine (pty-process)
    ↓
unix ptys (kernel)

philosophy

ai can interact with computers like humans do. no abstractions. just shells.

license

mit

README fetched from the repository yesterday. The original is authoritative.

Questions

About Terminal MCP

How do I install Terminal MCP?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Terminal MCP safe to use with an AI agent?

Its trust score is 39 out of 100 (low). It passes 3 of the 5 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Terminal MCP still maintained?

The last commit was 8 months ago and 3 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.