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

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

3. Edit configuration and credentials

4. Start the server

5. Check health and logs

6. Stop the server

Installing dependencies into the repo venv (dev only)

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:

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

• 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:

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