Iterm Terminal

🚀 iterm-mcp

iterm-mcp是一個為iTerm會話提供訪問的模型上下文協議（Model Context Protocol）服務器，能讓模型高效利用令牌，與iTerm自然集成，實現完整的終端控制和REPL支持，且依賴輕量級，使用便捷。

🚀 快速開始

iterm-mcp是一款強大的工具，為模型與iTerm會話的交互提供了便利。您可按照以下步驟進行安裝和使用。

✨ 主要特性

• 高效令牌使用：iterm-mcp能讓模型僅查看其感興趣的輸出部分。通常，模型只想查看長命令的最後幾行輸出，該特性可有效提高令牌使用效率。
• 自然集成：您可以與模型共享iTerm。您既可以詢問屏幕上的內容，也能委託任務給模型，並觀察其執行每一步操作，實現自然流暢的交互。
• 完整的終端控制和REPL支持：模型可以啟動並交互使用REPL環境，還能發送控制字符（如ctrl - c、ctrl - z等），實現對終端的完整控制。
• 輕量級依賴：iterm-mcp基於最小的依賴構建，可通過npx運行。它專為Claude Desktop和其他MCP客戶端設計，開箱即用，使用方便。

⚠️ 安全注意事項

⚠️ 重要提示

• 用戶需自行負責工具的安全使用。
• iterm-mcp未對命令的安全性進行評估，無內置限制。
• 模型可能會以意外方式行為，用戶需監控活動並在必要時終止操作。
• 對於多步驟任務，可能需要在模型偏離軌道時中斷它。建議從較小的、專注的任務開始，直至熟悉模型的行為。

🛠️ 工具

📋 要求

• 必須運行iTerm2。
• Node.js版本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安裝

自動為Claude Desktop安裝iTerm插件：

npx -y @smithery/cli install iterm-mcp --client claude

💻 開發

安裝依賴

yarn install

構建服務器

yarn run build

帶自動重建的開發

yarn run watch

調試

由於MCP服務器通過標準輸入和輸出進行通信，調試可能具有挑戰性。我們推薦使用MCP Inspector，它作為包腳本可用：

yarn run inspector
yarn debug <command>

Inspector會提供一個訪問調試工具的瀏覽器URL。