Overview
What is pty-mcp?
pty-mcp is an MCP tool server that provides a stateful terminal, enabling interactive terminal sessions through the Model Context Protocol. It is designed for developers and AI agents who need persistent command-line access within MCP-compatible environments.
How to use pty-mcp?
Install pty-mcp via pipx with pipx install git+https://github.com/qodo-ai/pty-mcp.git. After installation, the server is available as the command pty-mcp and can be configured as an MCP tool server in your MCP client.
Key features of pty-mcp
- Provides a stateful terminal session via MCP.
- Simple installation with pipx.
- Isolated environment via pipx.
- Designed for interactive command-line workflows.
Use cases of pty-mcp
- Running persistent terminal commands from an MCP client.
- Executing sequences of commands that require shared state.
- Providing an interactive shell for AI agents in an MCP environment.
FAQ from pty-mcp
What runtime does pty-mcp require?
pty-mcp requires Python and pipx for installation. It runs as a command-line server.
How is pty-mcp installed?
It is installed via pipx using pipx install git+https://github.com/qodo-ai/pty-mcp.git.
What command starts the server?
After installation, the server is invoked using the command pty-mcp.
Does pty-mcp support authentication or specific transports?
The README does not specify authentication or transport details; it is assumed to use standard MCP stdio transport.
