mcpterm
by dwrtz
mcpterm is an MCP tool server providing stateful, TUI-compatible terminal sessions. It is a proof-of-concept using mcp-go and works well with Claude Desktop.
Last updated: N/A
What is mcpterm?
mcpterm is a server that acts as an MCP tool, providing stateful terminal sessions that are compatible with TUI (Text-based User Interface) applications.
How to use mcpterm?
Clone the repository, run make to build the executable, and move the binary to a directory in your PATH. Then, configure Claude Desktop to use mcpterm by adding an entry in claude_desktop_config.json.
Key features of mcpterm
Stateful terminal sessions
TUI compatibility
Integration with Claude Desktop
Provides
runandrunScreentools
Use cases of mcpterm
Running commands in a stateful terminal session within Claude
Interacting with TUI applications like vim or python REPL through Claude
Automating tasks that require a persistent terminal environment
Writing a Dockerfile using vim with Claude and running the container
FAQ from mcpterm
What is MCP?
What is MCP?
Unfortunately, the readme does not provide relevant information about MCP.
What is a TUI?
What is a TUI?
Unfortunately, the readme does not provide relevant information about TUI. However, TUI stands for Text-based User Interface and it is a type of user interface that interacts with the user through text-based commands and output, rather than graphical elements.
How can I configure the tool with Claude Desktop?
How can I configure the tool with Claude Desktop?
Edit your claude_desktop_config.json (on Mac it's in ~/Library/Application Support/Claude/claude_desktop_config.json). Add a new entry for "mcpterm" under the "mcpServers" configuration.
What's the difference between the 'run' and 'runScreen' tools?
What's the difference between the 'run' and 'runScreen' tools?
The run tool executes a command in a stateful terminal session, preserving state between commands. The runScreen tool runs a command and returns the screen output, intended for TUI applications.
What are the supported control sequences for runScreen?
What are the supported control sequences for runScreen?
The README lists several control sequences for use with the runScreen tool, which are commonly used in TUI applications. Some include: Ctrl+X, Ctrl+O, Enter, Ctrl+C, Ctrl+D, Escape, Backspace, Carriage return, etc.