🚀 ht-mcp

ヘッドレスターミナル ht 用の高性能なRust実装のModel Context Protocol (MCP) サーバーです。

🚀 クイックスタート

ht-mcpは、ヘッドレスターミナル用の高性能なMCPサーバーです。以下の手順でインストールして使用できます。

✨ 主な機能

• 🚀 純粋なRust: シングルバイナリのMCPサーバーで、外部依存関係がありません。
• 🔗 直接統合: 優れた ht ヘッドレスターミナルライブラリを組み込み、最適なパフォーマンスを実現します。
• 🖥️ マルチセッション: 同時に複数のターミナルセッションを管理できます。
• 🌐 Webインターフェース: オプションでライブターミナルのプレビューが可能です。

📷 デモ

Memex でのht-mcp

Claude Code でのht-mcp

📦 インストール

🍺 Homebrew (推奨)

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

# 実行可能にしてインストール
chmod +x ht-mcp && sudo mv ht-mcp /usr/local/bin/

🦀 Cargo

# crates.io から (安定版)
cargo install ht-mcp

# git から (最新版)
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 .

詳細なインストールオプションについては、docs/INSTALLATION.md を参照してください。

🛠️ MCPツール

⚠️ 重要提示

パラメータはMCP互換性のためにキャメルケース (例: sessionId, enableWebServer) を使用しています。

⚙️ 設定

MCPクライアントの設定に追加します。

{
  "mcpServers": {
    "ht-mcp": {
      "command": "ht-mcp",
      "args": ["--debug"]
    }
  }
}

カスタムインストールパスの場合:

{
  "mcpServers": {
    "ht-mcp": {
      "command": "/path/to/ht-mcp",
      "args": []
    }
  }
}

💻 使用例

基本的な使用法

# MCPサーバーを起動
ht-mcp

# デバッグログを有効にして起動
ht-mcp --debug

MCPクライアントに設定した後:

1. セッションを作成: ht_create_session → セッションIDを返します。
2. コマンドを実行: セッションIDとコマンドを指定して ht_execute_command を実行します。
3. 対話的な入力: 多段階の対話には ht_send_keys を使用します。
4. 状態を確認: ht_take_snapshot で現在のターミナルの状態を確認します。
5. クリーンアップ: 終了したら ht_close_session でセッションを閉じます。

📄 レスポンス形式

このサーバーは、自然言語対話用に設計された人間が読めるテキストレスポンス (JSONではない) を返します。

# セッション作成レスポンス
HTセッションが正常に作成されました！

セッションID: abc123-def456-789...

🌐 Webサーバーが有効になりました！ライブターミナルはこちらから確認できます: http://127.0.0.1:3618

# ターミナルスナップショットレスポンス
ターミナルスナップショット (セッション: abc123...)

bash-3.2$ ls -la
合計 16
drwxr-xr-x  4 user staff  128 6月 13 10:30 .
-rw-r--r--  1 user staff   45 6月 13 10:30 file.txt
bash-3.2$

📋 要件

• Rust: 1.75+ (rustup を通じてインストール)
• サポートされるOS: Linux、macOS、Windows (実験的)

🛠️ 開発

# サブモジュール付きでクローン
git clone --recursive https://github.com/memextech/ht-mcp.git
cd ht-mcp

# ビルド
cargo build

# 実行
cargo run

# テスト
cargo test

🐞 トラブルシューティング

インストール時の問題

• Rust 1.75+ がインストールされていることを確認してください。
• gitサブモジュールのインターネット接続を確認してください。
• ~/.cargo/bin がPATHに含まれていることを確認してください。

実行時の問題

• 詳細なログを表示するには ht-mcp --debug を使用してください。
• MCPクライアントの設定構文を確認してください。
• バイナリのパスを確認するには which ht-mcp を実行してください。

⚡ パフォーマンス

元の TypeScript実装 と比較して:

• 起動速度が40倍速い (~50ms vs ~2s)
• メモリ使用量が70%少ない (~15MB vs ~50MB)
• シングルバイナリ (4.7MB vs ~200MB Node.js)
• サブプロセスのオーバーヘッドがゼロ

📄 ライセンス

Apache 2.0 License

Copyright (c) 2025 Atlas Futures Inc.

詳細については LICENSE を参照してください。

🤝 コントリビューション

コントリビューションを歓迎します！ガイドラインについては CONTRIBUTING.md を読んでください。

Memex で構築✨

サブモジュールのコミット参照を修正