JinDaGe - iterm-mcp MCP Details

article

README

🚀 iterm - mcp

iterm - mcp 是一个模型上下文协议（Model Context Protocol）服务器，它能为您提供对 iTerm 会话的访问权限，助力模型与 iTerm 高效交互。

主要图片

✨ 主要特性

高效令牌使用：iterm - mcp 可让模型精准查看其感兴趣的输出内容。通常情况下，即便面对长时间运行的命令，模型也只需查看命令执行的最后几行输出。
自然集成：您能与模型共享 iTerm。既可以询问屏幕上显示的内容，也能将任务委托给模型，还能直观看到模型执行每个步骤的过程。
完整的终端控制和 REPL 支持：模型能够启动并交互式地使用 REPL（例如 Python 的交互式解释器），还可发送控制字符（如 ctrl - c、ctrl - z 等）。
轻量级依赖：iterm - mcp 仅基于少量依赖项构建，可通过 npx 直接运行。它专为添加到 Claude Desktop 和其他 MCP 客户端而设计，基本可直接使用。

⚠️ 安全注意事项

⚠️ 重要提示

用户需自行确保工具的安全使用。

iterm - mcp 无内置限制，不会尝试评估命令的安全性。

模型的行为可能出乎意料，用户需要监控活动并在必要时终止操作。

对于多步任务，您可能需要在模型偏离轨道时进行干预。建议从较小的、专注的任务开始，直到熟悉模型的行为。

📦 安装指南

要与 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"
      ]
    }
  }
}

📚 详细文档

工具

| 属性 | 详情 | |------|------| | write_to_terminal | 向活动的 iTerm 终端写入内容，通常用于运行命令。返回命令执行产生的输出行数。 | | read_terminal_output | 从活动的 iTerm 终端读取指定数量的行。 | | send_control_character | 向活动的 iTerm 终端发送控制字符。 |

要求

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

iterm-mcp