iterm-mcp

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

功能特点

高效令牌使用： 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版本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，你可以在浏览器中访问调试工具。