Logo
Terminal MCP

Terminal MCP

A minimal, zero-dependency terminal MCP client built for coding agents. Bridges the gap between AI agents lacking native MCP support and the growing MCP ecosystem. Features a dual-binary architecture with agent-safe mode, sub-100ms startup times, and cross-platform binaries for Linux and macOS.

Visit Project
Bun TypeScript MCP SDK Cross-platform compilation

Features

  • Zero dependencies - standalone executable requiring no runtime installation
  • Cross-platform binaries for Linux (x64/ARM64) and macOS (Intel/Apple Silicon)
  • Agent-safe binary preventing configuration changes for security
  • Sub-100ms startup time
  • Dual transport support for HTTP and stdio MCP servers
  • Config file compatibility with Cursor, Claude Code, and other clients
  • Automatic tool discovery and schema extraction
  • Custom headers and authentication support
  • Codex-optimized output with intelligent line-breaking
  • Self-updating via GitHub releases

Challenge

Many AI coding agents, particularly OpenAI’s Codex, lack native MCP support, limiting their access to the growing ecosystem of MCP-enabled tools. Building a bridge requires fast startup, security considerations, and compatibility with existing configurations.

Solution

Built with Bun for blazing-fast compilation to standalone executables. Created a dual-binary architecture: developers get full control, agents receive a locked-down version that can only list and call tools. Added intelligent output formatting for constrained environments.

Highlights

  • Sub-100ms startup with zero dependencies
  • Dual-binary architecture for security
  • Compatible with existing MCP configurations