iterm-mcp

为您的iTerm会话提供访问的模型上下文协议（Model Context Protocol）服务器。

功能

高效令牌使用： iterm-mcp使模型能够仅查看其感兴趣的输出部分。模型通常只想查看长命令的最后几行输出。

自然集成： 您可以与模型共享iTerm。您可以询问屏幕上的内容，或委托任务给模型，并观察其执行每一步操作。

完整的终端控制和REPL支持： 模型可以启动并交互使用REPL环境，还可以发送控制字符（如ctrl-c、ctrl-z等）。

轻量级依赖： iterm-mcp基于最小的依赖构建，可通过npx运行。它专为Claude Desktop和其他MCP客户端设计，开箱即用。

安全注意事项

• 用户需自行负责工具的安全使用。
• 无内置限制：iterm-mcp未对命令的安全性进行评估。
• 模型可能会以意外方式行为。用户需监控活动并在必要时终止操作。
• 对于多步骤任务，可能需要在模型偏离轨道时中断它。从较小的、专注的任务开始，直至熟悉模型的行为。

工具

• write_to_terminal - 向当前iTerm终端写入内容，通常用于运行命令。返回命令输出的行数。
• read_terminal_output - 从当前iTerm终端读取指定数量的行。
• send_control_character - 向当前iTerm终端发送控制字符。

要求

• 必须运行iTerm2
• Node.js版本18或更高

安装

与Claude Desktop配合使用时，添加服务器配置：

在macOS上：~/Library/Application Support/Claude/claude_desktop_config.json 在Windows上：%APPDATA%/Claude/claude_desktop_config.json`

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

通过Smithery安装

自动为Claude Desktop安装iTerm插件：

npx -y @smithery/cli install iterm-mcp --client claude

开发

安装依赖：

yarn install

构建服务器：

yarn run build

带自动重建的开发：

yarn run watch

调试

由于MCP服务器通过标准输入和输出进行通信，调试可能具有挑战性。我们推荐使用MCP Inspector，它作为包脚本可用：

yarn run inspector
yarn debug <command>

Inspector会提供一个访问调试工具的浏览器URL。