mcpField
I
ITerm MCP Server

ITerm MCP Server

本地服务
github.com/rishabkoul开发工具1483 周前更新

关于 ITerm MCP Server

ITerm MCP Server 将 iTerm2 终端操作提供给 AI 助手,适用于使用 macOS 和 iTerm2 的开发者。它支持管理终端会话、执行命令及读取输出。

主要功能

  1. 01创建和管理终端会话
  2. 02在指定终端执行命令
  3. 03读取终端输出
  4. 04列出活动终端
  5. 05关闭终端会话

适用场景

  1. 01让 AI 助手在 iTerm2 中运行命令
  2. 02查看命令执行输出
  3. 03管理多个活动终端会话

MCP 相关

该服务通过 MCP 向客户端提供 iTerm2 终端工具,包括打开终端、执行命令、读取输出、列出和关闭终端。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"iTerm-MCP-Server": {
"command": "npx",
"args": [
"-y",
"iterm_mcp_server"
]
}
}
}
启动命令npx -y iterm_mcp_server

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmiterm_mcp_server

工具

5

收录的工具列表 · 更新于 3 周前

此工具无需参数。

详细介绍

ITerm MCP Server

一个用于集成 iTerm2 终端的模型上下文协议(MCP)服务实现。此服务允许 AI 助手通过模型上下文协议与 iTerm2 终端交互。

功能

  • 创建和管理 iTerm2 终端会话
  • 在终端中执行命令
  • 读取终端输出
  • 列出活动终端
  • 关闭终端

要求

  • Node.js >= 14.x
  • iTerm2
  • macOS(因为 iTerm2 仅支持 macOS)

配置

标准配置

此服务使用标准 MCP 配置选项,无需额外配置。

Cursor 配置

如需在 Cursor 中使用此服务,请将以下配置添加到 ~/.cursor/mcp.json 文件中:

{
  "mcpServers": {
    "terminal": {
      "command": "npx",
      "args": ["iterm_mcp_server"]
    }
  }
}

工具

  • open_terminal:打开一个新的终端实例
  • execute_command:在指定终端中执行命令
  • read_output:读取指定终端的输出
  • close_terminal:关闭指定终端
  • list_terminals:列出所有活动终端及其信息

安全注意事项

  • 服务使用 Zod 模式验证所有输入
  • 命令在隔离的终端会话中执行
  • 已实现适当的错误处理和输入清理

贡献

欢迎贡献!请随时提交 Pull Request。

许可证

ISC

作者

Rishab Koul

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。