MCP Linux Deployment

This repository contains an MCP server to manage Windows servers from Linux. It is designed for per-user installs under your home directory and does not write system-wide files.

Minimal runtime layout (after running ./scripts/setup.sh):

$HOME/MCPServer/ (per-user target)
- bin/ (start, stop, health_check, uninstall)
- config/ (application code and .env)
- venv/ (Python virtualenv)
- logs/
- run/

Essentials (what to keep in the repo):

server.py — MCP server entrypoint and tool registration
scripts/ — setup/start/stop/health_check/uninstall wrappers
requirements.txt — pinned dependencies

Quick start (per-user)

Make scripts executable

chmod +x scripts/*.sh

Create a per-user install (targets $HOME/MCPServer by default)

./scripts/setup.sh --target "$HOME/MCPServer"

Edit configuration and credentials

vi "$HOME/MCPServer/config/.env" # set MCP_HOST, MCP_PORT, WIN_DASH_API_BASE, MCP_API_TOKEN, WIN_DEFAULT_USER, WIN_DEFAULT_PASS

Start the server

"$HOME/MCPServer/bin/start.sh"

Check health and logs

"$HOME/MCPServer/bin/health_check.sh" tail -f "$HOME/MCPServer/logs/mcp-server.log"

Stop the server

"$HOME/MCPServer/bin/stop.sh"

Installing dependencies into the repo venv (dev only)

./venv/bin/python -m pip install -r requirements.txt

Troubleshooting highlights

Port binding: This server explicitly starts uvicorn with host=$MCP_HOST and port=$MCP_PORT. Default is 0.0.0.0:3000. Check with:

ss -ltnp | grep :${MCP_PORT:-3000} curl -v http://localhost:${MCP_PORT:-3000}/health

Missing packages: If you see ModuleNotFoundError, install requirements into the venv used by your install:

"$HOME/MCPServer/venv/bin/python" -m pip install -r requirements.txt

Logs and PIDs: logs are at <install>/logs/mcp-server.log; PID file at <install>/run/mcp-server.pid.

Support

Collect these artifacts if you need help debugging:

tail -n 200 "$HOME/MCPServer/logs/mcp-server.log" > mcp-debug.log ss -ltnp > ss-output.txt ps aux | grep server.py > ps-output.txt

This README is compact and contains runtime, install, and key troubleshooting steps to operate the MCP server on Linux.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables management of Windows servers from Linux through an MCP server with per-user installation. Provides tools to control Windows systems via API with secure credential management.

MCP Linux Deployment

New MCP Servers

MCP directory API