MCP Interactive Terminal Server

@danielp370-msft

About MCP Interactive Terminal Server

MCP server for interacting with a terminal or process based command over stdio.

Basic information

Category

Developer Tools

License

MIT license

Runtime

python

Transports

stdio

Publisher

danielp370-msft

Config

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

{
  "mcpServers": {
    "mcp_interactive_terminal": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "-m",
        "interactive.server"
      ]
    }
  }
}

Tools

No tools detected

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

Overview

What is MCP Interactive Terminal Server?

The MCP Interactive Terminal Server allows an AI agent to interact with command-line driven prompts, such as gdb, a UART console, or any REPL-based tool. Built with FastMCP, it provides tools for managing interactive terminal sessions and supports stdio, sse, and streamable-http transports.

How to use MCP Interactive Terminal Server?

Clone the repository, ensure Python 3.12+ and optionally UV Astral are installed, then run the server via the command line (e.g., uv run python -m interactive.server) or configure it in VS Code’s .vscode/mcp.json and start it through the MCP interface.

Key features of MCP Interactive Terminal Server

Start and manage interactive terminal sessions.
Wait for specific output or prompts with timeouts.
Send commands to active sessions.
Terminate sessions on demand.
Retrieve a list of all active sessions.

Use cases of MCP Interactive Terminal Server

Automating debugging sessions with gdb.
Interacting with UART console output.
Managing any REPL-based tool programmatically.
Running interactive Python sessions from an agent.

FAQ from MCP Interactive Terminal Server

What are the runtime prerequisites for MCP Interactive Terminal Server?

Python 3.12 or later is required. The UV Astral package manager is optional but recommended for handling dependencies.

What transport options does the server support?

The server supports stdio (default), sse, and streamable-http transports, selectable via command-line arguments.

Can I log the output of an interactive session?

Yes, the start_session tool accepts an optional log_file parameter to write all session output to a specified file.

How do I start a new interactive session?

Use the start_session tool with a command string and optional arguments list, e.g., start_session("python", ["-i"]) starts a Python REPL.

How do I retrieve active sessions?

Use the get_active_sessions tool to obtain a dictionary mapping session IDs to their current status.

Comments

More Developer Tools MCP servers

Hello World MCP Server (Reference Extension)

Desktop Extensions: One-click local MCP server installation in desktop apps

MCP-Scan: An MCP Security Scanner

invariantlabs-ai

Security scanner for AI agents, MCP servers and agent skills.

sentry-mcp

An MCP server for interacting with Sentry via LLMs.

MCP Unity Editor (Game Engine)

Model Context Protocol (MCP) plugin to connect with Unity Editor — designed for Cursor, Claude Code, Codex, Windsurf and other IDEs

Smithery CLI

Install, manage and develop MCP servers and skills for agents