iterm-mcp

一个模型上下文协议服务器，提供对 iTerm 会话的访问。

特性

高效的 Token 使用： iterm-mcp 使模型能够仅检查模型感兴趣的输出。即使对于长时间运行的命令，模型通常只想查看最后几行输出。

自然的集成： 您与模型共享 iTerm。您可以询问屏幕上的内容，或者将任务委托给模型并观看它执行每个步骤。

完整的终端控制和 REPL 支持： 模型可以启动并与 REPL 交互，以及发送控制字符，如 ctrl-c、ctrl-z 等。

易于依赖： iterm-mcp 以最小的依赖项构建，并且可以通过 npx 运行。它旨在易于添加到 Claude Desktop 和其他 MCP 客户端。它应该可以直接工作。

<a href="https://glama.ai/mcp/servers/h89lr05ty6"><img width="380" height="200" src="https://glama.ai/mcp/servers/h89lr05ty6/badge" alt="iTerm Server MCP server" /></a>

安全注意事项

• 用户有责任安全地使用该工具。
• 没有内置限制：iterm-mcp 不会尝试评估执行命令的安全性。
• 模型可能会以意想不到的方式运行。用户应监控活动并在适当的时候中止。
• 对于多步骤任务，如果模型偏离轨道，您可能需要中断它。从较小的、重点突出的任务开始，直到您熟悉模型的行为方式。

工具

• write_to_terminal - 写入到活动的 iTerm 终端，通常用于运行命令。返回命令产生的输出行数。
• read_terminal_output - 从活动的 iTerm 终端读取请求的行数。
• send_control_character - 向活动的 iTerm 终端发送控制字符。

要求

• iTerm2 必须正在运行
• Node 版本 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 安装

要通过 Smithery 自动为 Claude Desktop 安装 iTerm：

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

开发

安装依赖项：

yarn install

构建服务器：

yarn run build

对于具有自动重建功能的开发：

yarn run watch

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。我们建议使用 MCP Inspector，它作为包脚本提供：

yarn run inspector
yarn debug <command>

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