Iterm MCP Server

@ferrislucas

代码仓库主页

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

ferrislucas

关于 Iterm MCP Server

A Model Context Protocol server that executes commands in the current iTerm session - useful for REPL and CLI assistance

#ai #mcp#repl#claude #claude-ai #mcp-server

Iterm MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Iterm MCP Server 工具

Writes text to the active iTerm terminal - often used to run a command in the terminal

Reads the output from the active iTerm terminal

Sends a control character to the active iTerm terminal (e.g., Control-C, or special sequences like ']' for telnet escape)

概览

What is iterm-mcp?

iterm-mcp is a Model Context Protocol server that provides access to your iTerm session. It allows large language models to inspect terminal output, write commands, and send control characters directly to iTerm2.

How to use iterm-mcp?

Install iterm-mcp via npx (npx -y iterm-mcp) and add the server configuration to your MCP client, such as the Claude Desktop config file (claude_desktop_config.json). For a one‑click install, you can also use Smithery (npx -y @smithery/cli install iterm-mcp --client claude). iTerm2 must be running and Node version 18 or higher is required.

Key features of iterm-mcp

Efficient token use: model inspects only the output it needs.
Natural integration: share iTerm with the model and watch it work.
Full terminal control and REPL support with control characters.
Minimal dependencies, runnable via npx.
Easy setup with Claude Desktop and other MCP clients.

Use cases of iterm-mcp

Inspect the last few lines of output from long‑running commands.
Delegate multi‑step terminal tasks and observe each step.
Start and interact with REPLs (e.g., Python, Node).
Send control characters like ctrl‑c or ctrl‑z to manage processes.

常见问题

What are the safety considerations?

The user is responsible for using the tool safely. iterm‑mcp makes no attempt to evaluate the safety of commands, and models can behave unexpectedly. Users should monitor activity and abort when appropriate.

What are the system requirements?

iTerm2 must be running. Node version 18 or greater is required.

How do I install iterm-mcp for Claude Desktop?

Add the following entry to your Claude Desktop config file (`~/Library/Application Support/Claude/claude_desktop_config.json`): `{"mcpServers":{"iterm-mcp":{"command":"npx","args":["-y","iterm-mcp"]}}}`.

What tools does iterm-mcp provide?

Three tools: `write_to_terminal` (writes to the active terminal and returns line count), `read_terminal_output` (reads a requested number of lines), and `send_control_character` (sends control characters like ctrl‑c).

其他分类下的更多 MCP 服务器

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

ICSS

chokcoco

不止于 CSS

20.7K

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K