A Model Context Protocol (MCP) server implementation for iTerm2 terminal integration.
Created 3 months ago
A Model Context Protocol (MCP) server implementation for iTerm2 terminal integration.
What is A Model Context Protocol (MCP) server implementation for iTerm2 terminal integration.?
This server allows AI assistants to interact with iTerm2 terminals through the Model Context Protocol. Features include creating and managing iTerm2 terminal sessions, executing commands, reading terminal output, listing active terminals, and closing terminals.
Documentation
ITerm MCP Server
A Model Context Protocol (MCP) server implementation for iTerm2 terminal integration. This server allows AI assistants to interact with iTerm2 terminals through the Model Context Protocol.
Features
- Create and manage iTerm2 terminal sessions
- Execute commands in terminals
- Read terminal output
- List active terminals
- Close terminals
Requirements
- Node.js >= 14.x
- iTerm2
- macOS (since iTerm2 is macOS-only)
Configuration# Standard Configuration
The server uses the standard MCP configuration options. No additional configuration is required.
Cursor Configuration
To use this server with Cursor, add the following configuration to your ~/.cursor/mcp.json file:
{
"mcpServers": {
"terminal": {
"command": "npx",
"args": ["iterm_mcp_server"]
}
}
}
Tools
open_terminal: Open a new terminal instanceexecute_command: Execute a command in a specific terminalread_output: Read the output from a specific terminalclose_terminal: Close a specific terminallist_terminals: List all active terminals and their information
Security Considerations
- The server validates all input using Zod schemas
- Commands are executed in isolated terminal sessions
- Proper error handling and input sanitization is implemented
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
ISC
Author
Rishab Koul
Server Config
{
"mcpServers": {
"a-model-context-protocol-(mcp)-server-implementation-for-iterm2-terminal-integration.-server": {
"command": "npx",
"args": [
"a-model-context-protocol-(mcp)-server-implementation-for-iterm2-terminal-integration."
]
}
}
}