Vitjas Interactive Terminal

🖥️ 交互式终端MCP服务器

](https://badge.fury.io/py/vitjas-interactive-terminal) 

用于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
    }
  }
}

🛠️ 可用工具

⌨️ 支持的密钥

• 导航： 向上、向下、向左、向右、主页、结束、向上翻页、向下翻页
• 控制： 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 -