Refactor MCP server to modular architecture

Reorganized the MCP server into a modular structure with separate directories for core logic, services, utilities, and configuration. Introduced service classes for HR, tech support, and general tools, and implemented a factory pattern for tool registration. Added FastAPI-based HTTP API with authentication, Docker support, environment-based configuration, and comprehensive test scaffolding. Removed legacy test client and updated main server entry point for dual HTTP/MCP protocol support.

Author: Fr4nc3

src/backend/v3/mcp_server/.env.example

@@ -0,0 +1,15 @@
+# MCP Server Configuration
+
+# Server Settings
+MCP_HOST=0.0.0.0
+MCP_PORT=9000
+MCP_DEBUG=false
+MCP_SERVER_NAME=MACAE MCP Server
+
+# Authentication Settings
+MCP_ENABLE_AUTH=true
+AZURE_TENANT_ID=your-tenant-id-here
+AZURE_CLIENT_ID=your-client-id-here
+AZURE_JWKS_URI=https://login.microsoftonline.com/your-tenant-id/discovery/v2.0/keys
+AZURE_ISSUER=https://sts.windows.net/your-tenant-id/
+AZURE_AUDIENCE=api://your-client-id

src/backend/v3/mcp_server/Dockerfile

@@ -0,0 +1,32 @@
+FROM python:3.11-slim
+
+# Set working directory
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    gcc \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements first for better caching
+COPY requirements.txt .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy the application
+COPY . .
+
+# Create non-root user
+RUN useradd --create-home --shell /bin/bash app && chown -R app:app /app
+USER app
+
+# Expose port
+EXPOSE 9000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=30s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:9000/health || exit 1
+
+# Default command
+CMD ["python", "mcp_server.py"]