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版本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，以便您可以在浏览器中访问调试工具。