Headless Terminal (ht) MCP
About
A high-performance MCP server for the headless terminal (ht), implemented in Rust.
Details
- Author
- memextech
- Categories
- Developer Tools, Infrastructure, Other, Cloud Service
Jump to
Setup
Install Headless Terminal (ht) MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/memextech/ht-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
A high-performance MCP server for the headless terminal (ht), implemented in Rust.
A high-performance Rust implementation of a Model Context Protocol (MCP) server for headless terminalht.
- 🚀Pure Rust: Single binary MCP server, no external dependencies
- 🔗Direct Integration: Embed excellenththeadless terminal library for optimal performance
- 🖥️Multi-Session: Concurrent terminal session management
- 🌐Web Interface: Optional live terminal preview
brew tap memextech/tap brew install ht-mcp
# macOS Intel curl -L https://github.com/memextech/ht-mcp/releases/latest/download/ht-mcp-x86_64-apple-darwin -o ht-mcp # macOS Apple Silicon curl -L https://github.com/memextech/ht-mcp/releases/latest/download/ht-mcp-aarch64-apple-darwin -o ht-mcp # Linux curl -L https://github.com/memextech/ht-mcp/releases/latest/download/ht-mcp-x86_64-unknown-linux-gnu -o ht-mcp # Windows (PowerShell) curl.exe -L https://github.com/memextech/ht-mcp/releases/latest/download/ht-mcp-x86_64-pc-windows-msvc -o ht-mcp.exe # Make executable and install chmod +x ht-mcp && sudo mv ht-mcp /usr/local/bin/
# From crates.io (stable) cargo install ht-mcp # From git (latest) cargo install --git https://github.com/memextech/ht-mcp
git clone https://github.com/memextech/ht-mcp.git cd ht-mcp git submodule update --init --recursive cargo install --path .
Seedocs/INSTALLATION.mdfor detailed installation options.
Note: Parameters use camelCase (e.g.,sessionId,enableWebServer) for MCP compatibility.
{ "mcpServers": { "ht-mcp": { "command": "ht-mcp", "args": ["--debug"] } } }
{ "mcpServers": { "ht-mcp": { "command": "/path/to/ht-mcp", "args": [] } } }
# Start the MCP server ht-mcp # With debug logging ht-mcp --debug
- Create session:ht_create_session→ Returns session ID
- Run commands:ht_execute_commandwith session ID and command
- Interactive input:ht_send_keysfor multi-step interactions
- Check state:ht_take_snapshotto see current terminal
- Clean up:ht_close_sessionwhen finished
This server returnshuman-readable text responses(not JSON), designed for natural language interaction:
# Create session response HT session created successfully! Session ID: abc123-def456-789... 🌐 Web server enabled! View live terminal at: http://127.0.0.1:3618
# Terminal snapshot response Terminal Snapshot (Session: abc123...) bash-3.2$ ls -la total 16 drwxr-xr-x 4 user staff 128 Jun 13 10:30 . -rw-r--r-- 1 user staff 45 Jun 13 10:30 file.txt bash-3.2$
- Rust: 1.75+ (install viarustup)
- Supported OS: Linux, macOS, Windows (experimental)
# Clone with submodules git clone --recursive https://github.com/memextech/ht-mcp.git cd ht-mcp # Build cargo build # Run cargo run # Test cargo test
- Ensure Rust 1.75+ is installed
- Check internet connection for git submodules
- Verify~/.cargo/binis in PATH
- Useht-mcp --debugfor verbose logging
- Check MCP client configuration syntax
- Verify binary path:which ht-mcp
Compared to the originalTypeScript implementation:
- 40x faster startup(~50ms vs ~2s)
- 70% less memory(~15MB vs ~50MB)
- Single binary(4.7MB vs ~200MB Node.js)
- Zero subprocess overhead
Contributions welcome! Please readCONTRIBUTING.mdfor guidelines.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Execute pre-approved shell commands securely on a server.
Execute shell commands with permission notifications.
Execute pre-configured and secure shell commands via a Go-based MCP server.
An MCP server that provides SSH-based remote management tools, acting as proxy
All Azure MCP tools in a single server. The Azure MCP Server implements the MCP specification to create a seamless connection between AI agents and Azure services. Azure MCP Server can be used alone or with the GitHub Copilot for Azure extension in VS Code.
The Railway MCP Server enables natural language interaction with your Railway projects and infrastructure. Ask your IDE or AI assistant to create projects, deploy templates, manage environments, pull variables, redeploy services, and more.
The Shipyard CLI provides an MCP server for agents to manage Shipyard environments directly: by pulling logs, comparing branches, running tests, and stopping/starting environments..
Secure virtual machines for agents hosted by Superserve
An example of a remote MCP server deployed on Cloudflare Workers without authentication.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
