MCP Terminal Server

@cwmoore-ai

About MCP Terminal Server

A lightweight FastAPI server that can run as a Windows service and exposes an endpoint to execute shell commands and stream their output

#mcp-terminal-server #fastapi #windows-service

Config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

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 Terminal Server?

A lightweight FastAPI server that runs as a Windows service and exposes an endpoint to execute shell commands and stream their output in real-time. It includes API key authentication, rate limiting, and configurable logging.

How to use MCP Terminal Server?

Install via the provided PowerShell script (install_service.ps1) with optional parameters for API key, port, host, and log level. Configure through environment variables or a JSON config file. Manage the service using service.py commands (install, start, stop, restart, remove, debug). Use the test client (test_client.py) or call the API endpoints directly (POST /run, GET /health) with the API key in the X-API-Key header.

Key features of MCP Terminal Server?

Run as a Windows service or in debug mode
Execute shell commands and stream output in real-time
API key authentication and rate limiting
Configurable via environment variables or configuration file
Robust error handling and logging
Automatic process restart on failure

Use cases of MCP Terminal Server?

Remotely execute shell commands on a Windows server via API
Automate administrative tasks using scripted API calls
Interactive command-line access through the test client with command history
Monitor server health and active sessions with the /health endpoint
Integrate terminal command execution into larger applications or workflows

FAQ from MCP Terminal Server

What are the prerequisites to install MCP Terminal Server?

Windows operating system, Python 3.7 or higher, and administrator privileges (for service installation).

How do I configure the API key?

Set the API key via the -ApiKey parameter during installation, the MCP_TERMINAL_API_KEY environment variable, or in the client configuration file (client_config.json).

How can I run the server temporarily without installing a service?

Use debug mode by running python service.py debug from the terminal.

What API endpoints are available?

POST /run executes a command (requires API key, returns streaming output), and GET /health returns server health status.

Are dangerous commands blocked?

The server blocks potentially dangerous commands, but additional security measures are recommended in production.

Frequently asked questions

What are the prerequisites to install MCP Terminal Server?

Windows operating system, Python 3.7 or higher, and administrator privileges (for service installation).

How do I configure the API key?

Set the API key via the `-ApiKey` parameter during installation, the `MCP_TERMINAL_API_KEY` environment variable, or in the client configuration file (`client_config.json`).

How can I run the server temporarily without installing a service?

Use debug mode by running `python service.py debug` from the terminal.

What API endpoints are available?

`POST /run` executes a command (requires API key, returns streaming output), and `GET /health` returns server health status.

Are dangerous commands blocked?

The server blocks potentially dangerous commands, but additional security measures are recommended in production.

Comments

Basic information

More Developer Tools MCP servers

Reelier

Maxime Houle

Agents make claims. Reelier writes receipts — record an agent's tool-call workflow once, replay it deterministically at 0 tokens, and diff runs to catch drift.

discoverGPT

Joe Monastiero

discoverGPT is visualAI's unified MCP gateway for AI commerce, exposing 29 tools across four capabilities on one canonical product catalog: trimodal search (natural-language, precise-color, and image-similarity), AI cata

Air Pipe

airpipe

Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.

extentos

Asger mølgaard

Extentos is a multi-vendor development platform for adding smart-glasses capabilities to existing iOS and Android apps. The simplest analogy is Stripe for smart glasses:

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.