shield_lock
JinDaGe
← Back to MCP directory
publicPublicdnsLocal runtime

iTerm-MCP-Server

一个为iTerm2终端集成实现的MCP服务器，支持通过Model Context Protocol协议让AI助手与iTerm2终端交互

article

README

🚀 iTerm MCP 服务器

iTerm MCP 服务器是一个可与 iTerm2 终端集成的模型上下文协议 (MCP) 服务器实现。它借助 Model Context Protocol，让 AI 助手能够与 iTerm2 终端进行交互，为终端操作带来更多便利。

✨ 主要特性

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

📦 安装指南

需求

  • Node.js >= 14.x
  • iTerm2
  • macOS（因为 iTerm2 仅限于 macOS）

📚 详细文档

配置

标准配置

服务器使用标准的 MCP 配置选项，无需额外配置。

游标配置

要在游标中使用此服务器，请将以下配置添加到 ~/.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

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client