An MCP server that lets AI agents act like a human at a real terminal, local or over SSH.
io.github.open-mcp-ai/termcp MCP Server
An MCP server that enables AI agents to operate like a human at a real terminal, either locally or over SSH. It is identified by the slug io-github-open-mcp-ai-termcp and described as providing terminal interaction capabilities for agent workflows.
🛠️ Key Features
Terminal-based interaction for AI agents
Supports running locally
Supports connecting over SSH
🚀 Use Cases
Use AI agents to perform terminal actions as if a person were operating the session
Manage or automate tasks in environments accessible via SSH
Perform terminal operations on local systems through an MCP integration
⚡ Developer Benefits
Clear mapping between agent actions and a terminal session
Works for both local and SSH-based terminal use
⚠️ Limitations
Terminal interaction details beyond “real terminal” operation are not provided in the available server data
An AI can install and use any number of MCP servers, dynamically, at run time.
An AI can write its own MCP server and hot-load it.
An AI can use SSH to manage hosts, approved and collaborated on by a human.
An AI can install and call MCP servers across machines over nothing but SSH.
Exactly one tool is exposed. Built on the Termcp protocol (Terminalization Model Context
Protocol): loading more MCP servers and skills does not grow the context.
A single dependency-free binary (10 MB+), cross-platform, with a WYSIWYG web UI where a human
and an AI share the same terminals and collaborate.
Install 80+ MCP servers and skills.
Host management.
Install
0 · AI install
code
Install npx -y @open-mcp-ai/termcp daemon stdio as an MCP named termcp.
Copy this to the AI.
1 · One command per agent
Agent
Command
Claude Code
claude mcp add termcp -- npx -y @open-mcp-ai/termcp daemon stdio
Other install methods — npm / Go / Docker / prebuilt binary
Command
npm
npm i -g @open-mcp-ai/termcp — installs a termcp command; with it, drop npx -y @open-mcp-ai/termcp from every snippet above and use termcp. Wrapper: open-mcp-ai/Termcp-npm.
Go
go install github.com/open-mcp-ai/termcp@latest — GOPROXY=https://goproxy.cn,direct in mainland China; also usable as a module (go get github.com/open-mcp-ai/termcp).
Prebuilt releases — linux / darwin / windows on amd64 / arm64, one static file each.
The npm wrapper downloads the matching prebuilt binary (override with TERMCP_VERSION, TERMCP_MIRROR,
TERMCP_BIN, TERMCP_SKIP_DOWNLOAD). Flags: docs/cli.md. Docker recipes, Compose and a
token-free loopback setup: docs/deploy.md.
HTTP transport, when an instance is already answering somewhere (npx -y @open-mcp-ai/termcp):
Reachable from a client in Docker as http://host.docker.internal:18765/stream (macOS/Windows) or the host's
LAN IP; from another container on the same network as http://termcp:18765/stream. Legacy SSE uses
http://localhost:18765/sse — only /sse, JSON-RPC goes to /message by itself. With
--auth-token, add a bearer header: "headers": {"Authorization": "Bearer <token>"}.