iterm-mcp

查看源码
2025-5-12
Words 612Read Time 2 min
Score:85

一个MCP服务器,允许模型在iTerm会话中执行命令,支持REPL和CLI辅助功能。

TypeScript

iterm-mcp

一个提供访问 iTerm 会话的 Model Context Protocol (MCP) 服务器。
!主图

功能特性

高效的 Token 使用: iterm-mcp 使模型能够仅检查其感兴趣的输出部分。即使对于长时间运行的命令,模型通常也只需要查看最后几行输出。
自然集成: 你可以与模型共享 iTerm。你可以询问屏幕上显示的内容,或将任务委托给模型,并观察它执行每个步骤。
完整的终端控制和 REPL 支持: 模型可以启动并与 REPL 交互,还可以发送控制字符,如 ctrl-cctrl-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

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 iTerm:

开发

安装依赖:
构建服务器:
开发时自动重建:

调试

由于 MCP 服务器通过 stdio 通信,调试可能具有挑战性。建议使用 MCP Inspector,它作为包脚本提供:
Inspector 将提供一个 URL,以便在浏览器中访问调试工具。
上一篇
mcp-opendart
下一篇
mcp-mifosx