selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

ht-mcp logo

Self-host ht-mcp

v0.1.3

Rust MCP server for headless terminal sessions

BetaOpen SourceApache-2.0
Updated8 months ago
LanguageRust
Setup difficultyEasy
Stars
217
Port
3618 (Web interface for live terminal preview)
Install with Linux
ht-mcp running in Memex showing terminal sessionht-mcp running in Claude Code showing terminal session

What is ht-mcp?

ht-mcp is a Model Context Protocol server written in Rust that gives AI assistants the ability to create and control headless terminal sessions through the ht library. It runs as a single standalone binary with no external dependencies, making it trivial to install via Homebrew, Cargo, or pre-built binaries for Linux, macOS, and Windows. The server exposes MCP tools for creating sessions, sending keystrokes, executing commands, capturing terminal snapshots, and listing or closing sessions. An optional web interface provides a live terminal preview on port 3618. It integrates with MCP-compatible clients such as Memex and Claude Code. The project is developed by Atlas Futures Inc. (memextech organization) under the Apache-2.0 license.

Should you self-host ht-mcp?

ht-mcp scores 42/100 on selfhost.directory (how scoring works) and ranks #122 of 166 in Developer Tools. It has 217 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. It is Apache-2.0-licensed and written mostly in Rust.

Its closest alternative on selfhost.directory is openhands (87/100, 92 105 stars). It scores higher overall, so compare the two before you pick. See ht-mcp vs openhands side by side.

Features

  • Human-readable text responses
  • Live terminal preview
  • MCP Server
  • MCP tool: ht_close_session
  • MCP tool: ht_create_session
  • MCP tool: ht_execute_command
  • MCP tool: ht_list_sessions
  • MCP tool: ht_send_keys
  • MCP tool: ht_take_snapshot
  • Multi-session terminal management
  • Pure Rust single binary

ht-mcp README

How to install ht-mcp

Install ht-mcp with Linux

Download from GitHub releases for Linux, macOS (Intel and Apple Silicon), and Windows

How to configure ht-mcp

  • commandCommand to run in the terminal session (optional)

    Command to run in the terminal session (optional)

  • --debugEnable debug logging

    Enable debug logging

  • enableWebServerEnable the web interface for live terminal preview (optional)

    Enable the web interface for live terminal preview (optional)

ht-mcp releases & version history

More in AI

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…