Adrianozagallo Home MCP Server

🚀 Model Context Protocol (MCP) Server

This repository contains Kubernetes configuration files for deploying the MCP server on Azure Kubernetes Service (AKS).

🚀 Quick Start

✨ Features

• The repository provides Kubernetes configuration files for deploying the MCP server on AKS.
• It details the project structure, deployment steps, configuration, health checks, monitoring, security, and scalability.

📦 Installation

Prerequisites

• Azure CLI
• kubectl
• Docker
• Node.js version 18+

Project Structure

.
├── k8s/
│   ├── deployment.yaml    # Kubernetes deployment configuration file
│   ├── service.yaml      # Kubernetes service configuration file
│   └── configmap.yaml    # Kubernetes ConfigMap for environment variables
├── src/                  # Source code directory
├── Dockerfile           # Container build configuration file
├── package.json         # Node.js dependency management file
└── tsconfig.json        # TypeScript configuration file

Deployment Steps

1. Build the Docker image:

docker build -t mcp-server:latest .

2. Push the image to the Azure Container Registry (ACR):

az acr login --name <your-acr-name>
docker tag mcp-server:latest <your-acr-name>.azurecr.io/mcp-server:latest
docker push <your-acr-name>.azurecr.io/mcp-server:latest

3. Apply the Kubernetes configuration files:

kubectl apply -f k8s/

4. Verify the deployment status:

kubectl get pods
kubectl get services

📚 Documentation

Configuration

The application can be configured through environment variables defined in the ConfigMap (k8s/configmap.yaml).

Health Checks

The application exposes a /health endpoint for Kubernetes health checks.

Monitoring

• Resource usage can be monitored via Azure Monitor.
• Application logs can be retrieved using the kubectl logs command.

Security

• The application uses the HTTPS protocol.
• Cross - Origin Resource Sharing (CORS) is configured for secure cross - origin requests.
• Rate limiting is implemented to prevent abuse attacks.
• HTTP security headers are enhanced using Helmet.js.

Scalability

The deployment is configured with 3 replica sets by default. It can be scaled according to requirements using the following command:

kubectl scale deployment mcp-server --replicas=<quantity>