Terminator MCP Server

@iris-networks

Basic information

About Terminator MCP Server

A lightweight Model Context Protocol (MCP) server written in Go that enables secure terminal command execution on macOS and Linux. Supports persistent shell sessions, configurable timeouts, and both HTTP (StreamableHTTP) and STDIO transports. Designed for AI integrations and auto

#mcp #terminal #automation

Terminator MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "terminal": {
      "type": "streamable-http",
      "url": "http://localhost:8080/mcp",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-p",
        "8080:8080",
        "-e",
        "MCP_COMMAND_TIMEOUT=30",
        "-e",
        "MCP_SHELL=/bin/bash",
        "shanurcsenitap/terminator:latest",
        "--http",
        "--host",
        "0.0.0.0",
        "--port",
        "8080"
      ]
    }
  }
}

Terminator MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list directly from this server's endpoint using the button above.

Overview

What is Terminator?

Terminator is a Model Context Protocol (MCP) server written in Go that provides secure terminal command execution with configurable timeouts and platform-specific support. It works on macOS and Linux, supports persistent shell sessions, and offers both STDIO and StreamableHTTP transport modes.

How to use Terminator?

Build the server with make build, then run it in STDIO mode (default) with ./mcp-terminal-server or in HTTP mode with --http --port 8080. For Claude Desktop, add the binary path and optional environment variables (e.g., MCP_COMMAND_TIMEOUT=30) to your claude_desktop_config.json. Docker images are also available for multi‑architecture deployment.

Key features of Terminator

Cross‑platform support (macOS and Linux, AMD64 & ARM64)
Configurable command timeouts
Secure execution with proper error handling
Platform‑aware shell adaptation
Multiple transport modes: STDIO and StreamableHTTP
Persistent shell sessions that maintain state across commands

Use cases of Terminator

Execute terminal commands directly from Claude Desktop
Automate complex terminal workflows with the Iris Computer Use Agent
Run interactive or long‑running commands in persistent shell sessions
Deploy as a microservice inside Docker containers for isolated command execution

Frequently asked questions

What runtime environment does Terminator require?

Go 1.23+ (automatically managed) and the `github.com/mark3labs/mcp-go` library. For Docker deployments, any container runtime that supports multi‑architecture images.

Which platforms does Terminator support?

Full support for macOS (darwin) and Linux, both AMD64 and ARM64 architectures. Windows is not mentioned.

How does Terminator's session management work?

You can use any session ID without pre‑registration. Persistent shell sessions keep state (working directory, environment variables) between commands.

What transport modes does Terminator support?

STDIO mode for traditional MCP clients and StreamableHTTP transport (HTTP‑based) for web integrations. The HTTP endpoint is `POST /mcp` and requires a `Mcp-Session-Id` header for authenticated requests.

What security measures does Terminator provide?

Commands run in a controlled environment with non‑root execution, resource limits, network isolation (bind to localhost), and optional AppArmor/SELinux support. File permissions are restricted to necessary directories.

Comments

More Developer Tools MCP servers

Perfex CRM

themesic

Turn Perfex CRM into an AI-ready workspace. This MCP server exposes your full REST API to Claude, ChatGPT and any AI agent, so leads, invoices and tasks are one prompt away.

Raccha AI

Shree Mandadi

MCP-first toolbox for agents: namespaced key-value storage, a FIFO queue, auth, and a handful of stateless utility tools (JWT decode, hashing, cert inspection, CIDR math). Free while in early access. This repository is a

DocBin

Give an agent a place to put large output. Instead of returning 40k characters of a build log into the conversation, it posts the file to DocBin and hands back one short URL. Docs render with syntax highlighting and mark

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.