mcpterm MCP Server

@dwrtz

Repository

Basic information

About mcpterm MCP Server

An MCP tool server that provides stateful, TUI-compatible terminal sessions.

#model-context-protocol #mcp-server

mcpterm MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

mcpterm MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is mcpterm?

mcpterm is an MCP tool server that provides stateful, TUI‑compatible terminal sessions. It is a proof‑of‑concept built with mcp‑go and works well with Claude Desktop.

How to use mcpterm?

Clone the repository, run make to generate the bin/mcpterm binary, and move it to a directory in your PATH (e.g., /usr/local/bin/mcpterm). Then add it as an MCP server in your claude_desktop_config.json with the command "mcpterm" and no arguments, then restart Claude Desktop.

Key features of mcpterm

Stateful terminal sessions (subsequent commands share the same shell state).
TUI‑compatible screen output via the runScreen tool.
Two distinct tools: run (stateful command execution) and runScreen (return screen output for TUI apps).
Integrates with Claude Desktop out of the box.
Supports control sequences for interacting with terminal apps (e.g., vim, python REPL).

Use cases of mcpterm

Running a series of commands that depend on previous directory changes or environment variables.
Interacting with TUI applications such as vim or a Python REPL through Claude.
Writing a Dockerfile in vim, then building and running the container in the same session.
Executing commands inside a container from a stateful shell session.
Combining multiple command‑line tools in a persistent workspace via Claude.

Frequently asked questions

What tools does mcpterm provide?

mcpterm provides two tools: `run` for running a command in a stateful terminal session, and `runScreen` for running a command or series of keystrokes and returning the screen output.

How do I install mcpterm?

Clone the repository (`git clone https://github.com/dwrtz/mcpterm.git`), run `make` to build the binary, and move `bin/mcpterm` to a directory in your PATH (e.g., `sudo mv bin/mcpterm /usr/local/bin/mcpterm`).

Which MCP client is mcpterm compatible with?

The README states it works quite well with Claude Desktop. No other clients are mentioned.

What control sequences are supported for the `runScreen` tool?

The README lists common control sequences such as `^C` (Ctrl+C), `^D` (Ctrl+D), `^Z` (Ctrl+Z), `^[` (Escape), `^H` (Backspace), `^M` (Carriage return), and others. These are passed as hex codes (e.g., `"\x03"` for Ctrl+C).

Can mcpterm be used with non‑TUI commands?

Yes, the `run` tool executes any command in a stateful session, and the `runScreen` tool can also be used for non‑TUI commands, though it is intended for TUI apps.

Comments

More Other MCP servers

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K