AI导哈

交互式终端MCP服务器

一个为AI代理提供完全交互式终端控制的MCP服务器，支持TUI应用、键盘控制和屏幕捕获，跨平台运行于Windows、Linux和Mac。

  • by Vltja
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Vltja/vitjas-interactive-terminal

使用说明

🖥️ 交互式终端MCP服务器

用于AI代理的完全交互式终端MCP服务器，具有 TUI支持, 键盘控制，以及 屏幕截图 -跨平台（Windows、Linux、Mac）。

✨ 特性

  • 🖥️ 全终端控制 -创建、管理和删除终端会话
  • ⌨️ 键盘支持 -箭头键、Ctrl、Alt、F键、向上/向下翻页等。
  • 📺 TUI应用 -适用于htop、vim、nano、mc等
  • 🔄 自动更新 -自动检查并安装来自PyPI的更新
  • 🌍 交叉平台的 -Windows（pywinpty）、Linux/Mac（ptyprocess）

📦 安装

pip install vitjas-interactive-terminal

🚀 用法

启动MCP服务器

您可以在中启动服务器 3种方式:

# Option 1: Entry Point (recommended)
vitjas-interactive-terminal

# Option 2: Python Module
python -m interactive_terminal

# Option 3: Python3 Module (Linux/Mac)
python3 -m interactive_terminal

MCP配置

对于克劳德桌面/零号代理：

Linux/Mac（选项A-入口点）：

{
  "mcpServers": {
    "InteractiveTerminal": {
      "command": "vitjas-interactive-terminal",
      "args": [],
      "init_timeout": 30
    }
  }
}

Linux/Mac（选项B-Python 3模块）：

{
  "mcpServers": {
    "InteractiveTerminal": {
      "command": "python3",
      "args": ["-m", "interactive_terminal"],
      "init_timeout": 30
    }
  }
}

窗户：

{
  "mcpServers": {
    "InteractiveTerminal": {
      "command": "python",
      "args": ["-m", "interactive_terminal"],
      "init_timeout": 30
    }
  }
}

🛠️ 可用工具

工具 说明
create_terminal 创建新的交互式终端会话
send_text 向终端发送文本/命令
send_keys 发送特殊键（箭头、Ctrl+C等）
get_screen 读取终端屏幕内容
list_terminals 列出所有活动终端
delete_terminal 删除/关闭终端
search_buffer 搜索终端历史记录

⌨️ 支持的密钥

  • 导航： 向上、向下、向左、向右、主页、结束、向上翻页、向下翻页
  • 控制： ctrl+c、ctrl+d、ctrl+z、ctrl+a、ctrl+e、ctrl+u、ctrl+k、ctrl+w、ctrl+l
  • 中高音： alt+f、alt+b、alt+d
  • 其他： 回车、转义、制表、退格、删除、f1-f12

💡 例子

导航htop：

# Create terminal and start htop
create_terminal → send_text("htop\n") → get_screen()
# Navigate with arrow keys
send_keys("down") → send_keys("enter")
# Exit
send_keys("f10") or send_keys("q")

使用nano编辑：

# Create and open file
create_terminal → send_text("nano test.txt\n")
# Type content
send_text("Hello World!")
# Save and exit
send_keys("ctrl+x") → send_text("Y") → send_keys("enter")

🔧 配置

禁用自动更新：

VITJAS_AUTO_UPDATE=false vitjas-interactive-terminal

📋 需求

  • Python>=3.10
  • 窗户： pywinpty>=2.0.0（自动安装）
  • Linux/Mac： ptyprocess>=0.7.0（自动安装）

🔗 链接

  • PyPI： https://pypi.org/project/vitjas-interactive-terminal/
  • github： https://github.com/Vltja/vitjas-interactive-terminal
  • 问题： https://github.com/Vltja/vitjas-interactive-terminal/issues

📜 许可证

MIT许可证-请参阅 许可证

👤 作者

Vltja - GitHub

相关 MCP