Terminal MCP Server

io.github.aybelatchanePublished by GitHub account aybelatchanev1.0.3Updated Oct 24, 2026

MCP server for AI agents to interact with terminal applications. Think Playwright for terminals.

The publisher's own server: Terminal Tax

VerifiedSTDIODesktop onlyBrowser Automation Developer Tools

Server details

Identifier: io.github.aybelatchane/mcp-server-terminal
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account aybelatchane for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.aybelatchane%2Fmcp-server-terminal.svg)](https://sourceweft.com/mcp/io.github.aybelatchane%2Fmcp-server-terminal?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

A local MCP server that lets an AI assistant drive terminal applications: start sessions, snapshot terminal state, type, press keys, click UI elements and read.

What you can do: Manage terminal sessions: create, list, close and resize sessions running terminal programs such as htop or shell commands. Inspect terminal state: capture snapshots with detected UI elements or read raw output. Send input: type text, press keys such as arrows, F-keys and Ctrl combinations, and click detected UI elements. Wait for conditions: block until expected text, an element or an idle state appears.
When to use it: Useful when an assistant needs to operate interactive terminal programs that have no API, such as TUI tools, menus or full-screen consoles, and to script keystroke-level interaction with them. It is a desktop-only tool, so it fits local development machines rather than hosted environments.
Requirements: Runs as a local process, typically via npx mcp-server-terminal, or as a pre-built binary; building from source needs a Rust toolchain. Visual mode spawns a visible terminal window and on Linux/WSL requires X11 with the DISPLAY environment variable set; headless mode is available with a flag. Windows native is headless only; WSL is recommended for full functionality. Optional RUST_LOG sets log level.

Before you install

The assistant can type arbitrary text and press keys in real terminal sessions, so commands may run with the user's privileges and change or delete data; review what it executes. Visual mode opens windows on the desktop. Logs go to stderr and can be made verbose with RUST_LOG.

Installation

In SourceWeft

Open Terminal MCP Server in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Terminal MCP Server

[npm version] [npm downloads] [License: MIT]

MCP server enabling AI agents to interact with terminal applications through structured Terminal State Tree representation. Works with any AI assistant that supports the Model Context Protocol.

Installation

Via npm (Recommended)

Via GitHub Releases

Download pre-built binaries from Releases.

Build from Source

bash

git clone https://github.com/aybelatchane/mcp-server-terminal.gitcd mcp-server-terminalcargo build --release# Binary: ./target/release/terminal-mcp

git clone https://github.com/aybelatchane/mcp-server-terminal.gitcd mcp-server-terminalcargo build --release# Binary: ./target/release/terminal-mcp

Configuration

Claude

Claude Code (CLI)

Claude Desktop

Add to ~/.claude.json (macOS/Linux) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"]    }  }}

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"]    }  }}

OpenAI Codex

Codex CLI

Codex Configuration File

Add to ~/.codex/config.toml:

Google Gemini

Gemini CLI

VS Code / GitHub Copilot

VS Code 1.101+ supports MCP. Add to your VS Code settings (settings.json):

json

{  "mcp.servers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"]    }  }}

{  "mcp.servers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"]    }  }}

Cursor

Add to ~/.cursor/mcp.json or .cursor/mcp.json in your project:

json

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"]    }  }}

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"]    }  }}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

json

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"]    }  }}

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"]    }  }}

Zed

Add to your Zed settings (Preferences → Settings):

json

{  "context_servers": {    "terminal": {      "command": {        "path": "npx",        "args": ["mcp-server-terminal"]      }    }  }}

{  "context_servers": {    "terminal": {      "command": {        "path": "npx",        "args": ["mcp-server-terminal"]      }    }  }}

Cline (VS Code Extension)

Click MCP Servers icon → Configure → Advanced MCP Settings, then add:

json

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"]    }  }}

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"]    }  }}

AWS Bedrock

Add to your Bedrock agent MCP configuration:

json

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"]    }  }}

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"]    }  }}

Other MCP Clients

For any MCP-compatible client, configure the server with:

Command: npx
Args: ["mcp-server-terminal"]

Or if using the binary directly:

Command: terminal-mcp

Usage

Ask your AI agent:

"Create a terminal session running htop"
"Take a snapshot of the terminal"
"Press the down arrow key"
"Type 'ls -la' and press Enter"

MCP Tools

Tool	Description
`terminal_session_create`	Start a terminal session
`terminal_session_list`	List active sessions
`terminal_session_close`	Close a session
`terminal_session_resize`	Resize terminal dimensions
`terminal_snapshot`	Capture terminal state with UI elements
`terminal_type`	Type text into terminal
`terminal_press_key`	Press keys (arrows, F-keys, Ctrl+X)
`terminal_click`	Click on detected UI element
`terminal_wait_for`	Wait for text, element, or idle state
`terminal_read_output`	Read raw terminal output

Visual Mode

By default, sessions spawn a visible terminal window (xterm). For headless operation:

Or in your MCP config:

json

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal", "--headless"]    }  }}

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal", "--headless"]    }  }}

X11 Setup (Linux/WSL)

Visual mode requires X11. Add the DISPLAY environment variable to your MCP config:

json

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"],      "env": {        "DISPLAY": ":0"      }    }  }}

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"],      "env": {        "DISPLAY": ":0"      }    }  }}

Logging

Set the RUST_LOG environment variable:

json

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"],      "env": {        "RUST_LOG": "info"      }    }  }}

{  "mcpServers": {    "terminal": {      "command": "npx",      "args": ["mcp-server-terminal"],      "env": {        "RUST_LOG": "info"      }    }  }}

Log levels: error, warn, info, debug, trace

Logs go to stderr (stdout is reserved for MCP protocol).

Platform Support

Platform	Architecture	Status	Visual Mode
Linux	x64, arm64	✅ Full support	xterm + tmux
macOS	x64, arm64	✅ Full support	Terminal.app / iTerm2
Windows (WSL)	x64, arm64	✅ Full support	xterm + tmux (via X11)
Windows (native)	x64	⚠️ Headless only	Not supported

Windows users: Use WSL for full functionality including visual mode.

License

MIT

Source: README.md at commit c532381

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.0.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Other Terminal integrations

Terminal Tax

tax.terminalOfficial publisher

Hosted tax-filing server that lets an assistant send a US federal 2025 individual return's facts, get it computed and checked, and hand back a private signing…

Streamable HTTPWeb executable

Productivity & Workflow3 toolsNov 6, 2026

Terminal

mn.dtaOfficial publisher

A remote MCP server for Mongolia's signed macro and market data archive, letting an assistant search series, pull panels and verify signed observations.

Streamable HTTPWeb executable

Finance5 toolsOct 24, 2026

SCRIPTMASTERLABS — Quant Terminal

com.scriptmasterlabs

Remote MCP endpoint offering real-data ticker levels and a "squeeze-mirror" projection for quantitative trading analysis.

Streamable HTTPWeb executable

FinanceNot indexed yetNov 5, 2026

Terminal 7

Published by GitHub account LinkMarine777

Signals, scores and payout data for stonkfun coins on Solana, for bots and AI agents.

Streamable HTTPWeb executableAuth

AI & ML7 toolsOct 25, 2026

terminal-use

Published by GitHub account computer-agent-labs

Lets an AI assistant drive real terminal sessions on your machine: type, press keys, click, read the screen and take screenshots, including full-screen TUIs.

STDIODesktop only

Browser Automation13 toolsOct 29, 2026