Skip to content

Terminal MCP for mac and linux

Choose a tag to compare

@codebanesr codebanesr released this 12 Jul 00:25
· 24 commits to main since this release

⏺ Release Notes - MCP Terminal Server

🎉 New Features

  • Build Automation: Added Makefile for streamlined build process
  • CI/CD Workflows: GitHub Actions workflows for automated testing and deployment
  • Enhanced Documentation: Updated README with comprehensive feature overview and integration guides

🔧 Core Features

  • Cross-platform Support: Full support for macOS and Linux environments
  • Persistent Shell Sessions: Maintain shell state between commands (working directory, environment variables)
  • Dual Transport Modes:
    • STDIO mode for traditional MCP clients
    • HTTP mode for web-based integrations
  • Configurable Timeouts: Set custom timeout values for command execution
  • Secure Execution: Commands run in controlled environment with proper error handling

🛠️ Available Tools

  1. execute_command - Execute single commands with timeout
  2. persistent_shell - Execute commands in persistent shell sessions
  3. session_manager - Manage shell sessions (list, close)

🚀 Quick Start

Build the server

go build -o mcp-terminal-server

Run in HTTP mode

./mcp-terminal-server -sse -port 8080

Run in STDIO mode (default)

./mcp-terminal-server

📚 Documentation

Complete documentation available in /docs including:

  • Quick Start Guide
  • Getting Started
  • Vercel AI SDK Integration
  • Architecture Overview

🔗 Integration

Works with Claude Desktop and other MCP clients. Used by the Iris Computer Use Agent for automated terminal interactions.