iterm-mcp
一个模型上下文协议服务器，可提供对您iTerm会话的访问。
功能
高效使用Token：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，您可以在浏览器中访问调试工具。