Waygate MCP is a production-ready enterprise MCP server implemented in Python. It exposes a suite of integrated MCP tools, including execute_command for safe system command execution with timeout protection, read_file and write_file for secure file I/O with path validation, list_directory for advanced directory listings with filtering, and search_files for content and filename search. The server also provides a TaskWarrior-based project management workflow, enabling real-time dashboards, automated fix prioritization, and professional reporting. Claude Desktop compatibility allows drop-in configuration and seamless tool invocation from Claude Desktop interfaces. Start the server in production mode to enable zero-trust networking and integrated security features, then query the health endpoint to verify operational status and access the tools API to list and invoke available MCP tools.

Prerequisites:

• Python 3.8+ and a supported operating system
• Git
• Internet access to install dependencies

Step-by-step:

1. Clone the repository: git clone https://github.com/waygateai/waygate-mcp.git cd waygate-mcp

2. Create and activate a virtual environment (recommended): python -m venv venv

   Linux/macOS

   source venv/bin/activate

   Windows

   venv\Scripts\activate

3. Install dependencies: pip install -r requirements.txt

4. Start the MCP server (production mode): python -m source.waygate_mcp --port 8000 --env production

5. Verify the server is running: curl http://localhost:8000/health

Optional for deployment:

• Use the provided deployment scripts and systemd service as documented in the repo to enable auto-start and monitoring.
• Configure Claude Desktop integration per the CLAUDE_DESKTOP_SETUP guide.

Notes and tips:

• The server runs on port 8000 by default; modify --port as needed.
• Production mode enables zero-trust networking and enterprise security features—ensure your reverse proxy (e.g., Nginx) and firewall settings align with security requirements.
• The MCP Tools API includes execute_command, read_file, write_file, list_directory, and search_files. Use with validated inputs to avoid security risks.
• For Claude Desktop integration, follow the Claude setup workflow in the repository; this enables natural language invocation of MCP tools.
• If you encounter startup issues, check that required dependencies from requirements.txt are compatible with your Python environment and that a valid virtual environment is activated.
• The system supports TaskWarrior for project management; consult the TaskWarrior scripts and dashboards provided in the repository for monitoring and reporting.