iTerm 세션에 접근할 수 있는 모델 컨텍스트 프로토콜 서버입니다.

특징

효율적인 토큰 사용: iterm-mcp는 모델이 관심 있는 출력만 검사할 수 있는 기능을 제공합니다. 모델은 일반적으로 장시간 실행 명령의 경우에도 출력 마지막 몇 줄만 보고 싶어 합니다.

자연스러운 통합: iTerm을 모델과 공유합니다. 화면에 무엇이 보이는지 질문하거나, 모델을 맡겨 각 단계를 지켜볼 수 있습니다.

완전한 터미널 제어 및 REPL 지원: 모델은 REPL을 시작하고 상호작용할 수 있으며, ctrl-c, ctrl-z 등과 같은 제어 문자도 전송할 수 있습니다.

의존성 부담 완화: iterm-mcp는 의존성을 최소화하며 npx로 실행할 수 있습니다. Claude Desktop과 다른 MCP 클라이언트에 쉽게 추가할 수 있도록 설계되었습니다. 그냥 잘 작동할 겁니다.

안전 고려사항

• 사용자는 도구를 안전하게 사용할 책임이 있습니다.
• 내장된 제한 없음: iterm-mcp는 실행된 명령의 안전성을 평가하려는 시도를 하지 않습니다.
• 모델은 예상치 못한 방식으로 행동할 수 있습니다. 사용자는 활동을 모니터링하고 적절할 때 중단해야 합니다.

iterm-mcp

A Model Context Protocol server that provides access to your iTerm session.

Features

Efficient Token Use: iterm-mcp gives the model the ability to inspect only the output that the model is interested in. The model typically only wants to see the last few lines of output even for long running commands.

Natural Integration: You share iTerm with the model. You can ask questions about what’s on the screen, or delegate a task to the model and watch as it performs each step.

Full Terminal Control and REPL support: The model can start and interact with REPL’s as well as send control characters like ctrl-c, ctrl-z, etc.

Easy on the Dependencies: iterm-mcp is built with minimal dependencies and is runnable via npx. It’s designed to be easy to add to Claude Desktop and other MCP clients. It should just work.

Safety Considerations

• The user is responsible for using the tool safely.
• No built-in restrictions: iterm-mcp makes no attempt to evaluate the safety of commands that are executed.
• Models can behave in unexpected ways. The user is expected to monitor activity and abort when appropriate.
• For multi-step tasks, you may need to interrupt the model if it goes off track. Start with smaller, focused tasks until you’re familiar with how the model behaves.

Tools

• write_to_terminal - Writes to the active iTerm terminal, often used to run a command. Returns the number of lines of output produced by the command.
• read_terminal_output - Reads the requested number of lines from the active iTerm terminal.
• send_control_character - Sends a control character to the active iTerm terminal.

Requirements

• iTerm2 must be running
• Node version 18 or greater

Installation

To use with Claude Desktop, add the server config:

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

Installing via Smithery

To install iTerm for Claude Desktop automatically via Smithery:

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

Development

Install dependencies:

yarn install

Build the server:

yarn run build

For development with auto-rebuild:

yarn run watch

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

yarn run inspector
yarn debug 

The Inspector will provide a URL to access debugging tools in your browser.