MCP Hub
Back to servers

PTY MCP Server

A TypeScript-based MCP server that provides programmatic management of pseudo-terminal (PTY) sessions, allowing for the spawning, control, and real-time interaction with terminal processes.

Updated
Jan 18, 2026

PTY MCP Server

pty-mcp is a Model Context Protocol (MCP) server designed to manage pseudo-terminal (PTY) sessions. Built with TypeScript and the Effect ecosystem, it provides a robust and type-safe interface for spawning, controlling, and interacting with terminal processes programmatically.

Features

  • Spawn Sessions: Create new PTY sessions with custom commands, arguments, and environment variables.
  • Interactive Control: Write data to stdin and read from stdout/stderr in real-time.
  • Session Management: List active sessions, monitor status, and terminate processes.
  • Effect Ecosystem: Leverages the power of the Effect library for error handling, concurrency, and resource management.
  • MCP Integration: Seamlessly exposes PTY capabilities to MCP-compliant clients.

Installation

pnpm install

Usage

Build

pnpm run build

Start Server

pnpm start

Testing

pnpm run test

Author

Ali Almahdi Digital Innovation Architect & AI Enthusiast

Crafting the future of technology at the intersection of AI and human experience.

License

This project is licensed under the AGPL-3.0 License. See the LICENSE file for details.

Reviews

No reviews yet

Sign in to write a review