home / mcp / waygate mcp server

Waygate MCP Server

Enterprise MCP server framework with secure file ops, command execution, and TaskWarrior integration. Zero-config security, Claude Desktop ready, comprehensive audit logging.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jeremylongshore-waygate-mcp": {
      "command": "python",
      "args": [
        "-m",
        "source.waygate_mcp",
        "--port",
        "8000",
        "--env",
        "production"
      ]
    }
  }
}

Waygate MCP Server is a production-ready, enterprise-grade framework that provides a complete set of MCP tools, zero-trust security, TaskWarrior project management integration, and seamless Claude Desktop compatibility. It enables you to run a centralized MCP server locally or in production to safely execute a range of managed tools, monitor health, and integrate with external clients.

How to use

You interact with the MCP server through a client that communicates with the local MCP process. Start the server, then perform actions such as listing available tools, running safe system commands, reading or writing files within protected zones, and viewing the real-time dashboard for health and status. Use the provided dashboard and health endpoints to confirm the server is operating correctly and your tools are ready for use.

How to install

Prerequisites: you need Python 3.12, a bash-compatible shell, and network access to install dependencies.

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

# 2) Set up a Python virtual environment
python -m venv venv
source venv/bin/activate  # Linux/macOS
# venv\Scripts\activate   # Windows

# 3) Install dependencies
pip install -r requirements.txt

# 4) Start the full MCP server with all tools
python -m source.waygate_mcp --port 8000 --env production

Additional sections

Security features and deployment details help keep your MCP server protected while remaining approachable for enterprise use.

Claude Desktop integration is supported for convenient interaction with tools by using a drop-in configuration and setup steps. After configuring, you can issue commands such as listing available MCP tools or using specific tools like list_directory directly from Claude Desktop.

TaskWarrior integration provides a real-time project dashboard, automated fix sequence generation, and a comprehensive project status overview to assist with project management and reporting.

Health checks and dashboards are available to monitor subsystem status and performance. Use the health endpoint to verify the server is running and the dashboard to review status and metrics.

If you need to revert to a minimal setup, a simple server option is available to run a basic HTTP server for limited functionality.

Configuration and running notes

The core startup command shows how to run the full MCP server with production settings. The command includes the module path, port specification, and environment flag to enable production safeguards.

Available tools

execute_command

Execute system commands with security validation and optional timeout to prevent unsafe or unbounded executions.

read_file

Read file contents with path validation and safe size limits to prevent unauthorized access.

write_file

Write content to files with safety checks and encoding support to avoid unsafe writes.

list_directory

List directory contents with optional recursive listing and glob pattern filtering for precise file discovery.

search_files

Search files by content or filename using a configurable query and path scope to locate relevant data quickly.