快速入门

安装

方法1：通过PyPI安装（推荐）

运行以下命令：

pip install terminal-controller

或者使用UV工具：

uv pip install terminal-controller

方法2：从源码安装

克隆仓库并运行安装脚本：

git clone https://github.com/GongRzhe/terminal-controller-mcp.git
cd terminal-controller-mcp
python setup_mcp.py

配置客户端

配置Claude Desktop客户端，添加如下内容到配置文件：

"terminal-controller": {
  "command": "uvx",
  "args": ["terminal_controller"]
}

macOS路径：~/Library/Application Support/Claude/claude_desktop_config.json。 Windows路径：%APPDATA%\Claude\claude_desktop_config.json。

使用示例

• 执行命令：ls -la
• 切换目录：cd ~/Documents
• 查看历史命令：get_command_history

更多用法参考API说明。