HT MCP

ht-mcp

无头终端模型上下文协议（MCP）服务器的高性能Rust实现 高温.

特性

• 🚀 纯锈：单个二进制MCP服务器，无外部依赖关系
• 🔗 直接积分法：嵌入优秀 高温 无头终端库，实现最佳性能
• 🖥️ 多会话：并发终端会话管理
• 🌐 web界面：可选实时终端预览

演示

ht-mcp in Memex

ht-mcp in 克劳德代码

安装

🍺 自制（推荐）

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 .

看 docs/INSTALLATION.md 有关详细的安装选项。

MCP工具

备注：参数使用camelCase（例如。， sessionId, enableWebServer)为了MCP兼容性。

配置

添加到MCP客户端配置中：

{
  "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

在MCP客户端中配置后：

1. 创建会话: ht_create_session → 返回会话ID
2. 运行命令: ht_execute_command 带有会话ID和命令
3. 交互式输入: ht_send_keys 用于多步骤交互
4. 检查状态: ht_take_snapshot 查看当前终端
5. 清理: ht_close_session 完成时

响应格式

此服务器返回 人类可读的文本响应 （非JSON），专为自然语言交互而设计：

# 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$

需求

• 锈：1.75+（通过安装 安宁)
• 支持的操作系统：Linux、macOS、Windows（实验版）

发展

# 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

故障排除

安装问题：

• 确保安装了Rust 1.75+
• 检查git子模块的互联网连接
• 验证 ~/.cargo/bin 在PATH中

运行时问题：

• 使用 ht-mcp --debug 用于详细日志记录
• 检查MCP客户端配置语法
• 验证二进制路径： which ht-mcp

演出

与原版相比 TypeScript实现:

• 启动速度提高40倍 （~50ms vs ~2s）
• 内存减少70% （约15MB对约50MB）
• 单个二进制 （4.7MB对比约200MB Node.js）
• 零子流程开销

许可证

Apache 2.0许可证

版权所有（c）2025 Atlas Futures股份有限公司。

看 许可证 了解详情。

贡献

欢迎投稿！请阅读 贡献.md 作为指导方针。

______________________________________________________________________

内置于 Memex✨

修复了子模块提交引用