MCP Terminal Server

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