MCPterm

Provides stateful, TUI-capable terminal sessions via a local MCP server for interactive command work.

go

12

GitHub Stars

go

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "dwrtz-mcpterm": {
      "command": "mcpterm",
      "args": []
    }
  }
}

You can use MCP to run stateful, terminal-like sessions directly from your MCP client. This MCP server provides a simple way to execute commands in a persistent or interactive terminal, enabling you to work with shells, editors, or REPLs inside integrated tools. It is especially handy for doing Docker builds, Vim, or other terminal-based workflows from within an MCP-enabled environment.

How to use

Connect to the mcpterm MCP server from your client. You will interact with a local, stateful terminal session that preserves your working directory and environment across commands. Use the two built-in tools to manage sessions:

run: Start a command in a persistent terminal. Your changes in the working directory persist across subsequent commands within the same session. - runScreen: Send a command or a sequence of keystrokes to a session and capture the resulting screen output. This is ideal for interactive applications like vim or a Python REPL.

Optional guidance: you can configure your MCP client to translate common keystrokes for interactive tools. For example, you can map control sequences to actions like sending Enter, Escape, or Ctrl-C to control terminal applications inside the session.

How to install

Prerequisites: you need a working development environment with the necessary build tools for the MCP server you are using. In this case, you will compile a local binary that exposes the MCP server endpoint.

Clone the project and build the binary.

Clone the repository to your machine and build the binary:

git clone https://github.com/dwrtz/mcpterm.git
cd mcpterm
make

Move the binary into your PATH so you can invoke it from anywhere.

sudo mv bin/mcpterm /usr/local/bin/mcpterm

Add the MCP server to Claude Desktop (or your MCP client) by editing the client configuration so it can load the new tool. The example uses a Claude Desktop configuration snippet.

{
  "mcpServers": {
    "mcpterm": {
      "command": "mcpterm",
      "args": []
    }
  }
}

Restart Claude Desktop or your MCP client to recognize the new server. You should then see the mcpterm tool available for use.

Configuration and usage notes

The server exposes a single stdio configuration that runs a local binary named mcpterm. The command and arguments shown below reflect how you start the server locally within the MCP ecosystem.

{
  "type": "stdio",
  "name": "mcpterm",
  "command": "mcpterm",
  "args": []
}

Available tools

run

Runs a command in a stateful terminal session so subsequent commands execute in the same working directory and environment.

runScreen

Runs a command or sequence of keystrokes and returns the terminal screen output, suitable for interactive TUI apps like vim or a Python REPL.