Terminal MCP Server
by aybelatchanecommunityv1.0.3
13
2
The MCP server enables AI agents to interact with terminal applications using a structured Terminal State Tree representation. It is compatible with any AI assistant that supports the Model Context Protocol.
From the registry: MCP server for AI agents to interact with terminal applications. Think Playwright for terminals.
Install & configure
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `mcp-server-terminal` MCP server into my current AI client (that's you).
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["mcp-server-terminal"]
- optional environment variables:
- `DISPLAY`: X11 DISPLAY for visual mode on Linux/WSL. (example: `:0`)
- `RUST_LOG`: Rust log level. (example: `info`)
Note: Add --headless flag for headless operation. Windows native only supports headless mode.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Add --headless flag for headless operation. Windows native only supports headless mode.
Tools (10)
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
Environment variables
DISPLAYrequiredRequired for visual mode on Linux/WSLRUST_LOGSet log level for the serverPackages
mcp-server-terminal
npmv1.0.3transport: stdio
Details
- Language
- Rust
- License
- MIT
- Released
- Dec 9, 2025
- Last commit
- Jan 2, 2026
- Registry name
- io.github.aybelatchane/mcp-server-terminal