MCP Linux Deployment

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)

1. Make scripts executable

chmod +x scripts/*.sh

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

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

3. 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

4. Start the server

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

5. Check health and logs

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

6. 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.