NFReconfig MCP Server

MCP (Model Context Protocol) server implementation for autonomous 5G Network Functions reconfiguration operations in cloud-native Kubernetes environments.

📋 Table of Contents

• Prerequisites
• Infrastructure Setup
• Installation
• Project Structure
• MCP Tools Reference
• Agent Configuration
• Related Projects
• License

🔧 Prerequisites

Required Software

• Go (1.23 or later)
• Docker
• kubectl
• Helm (v3.x)
• kmcp - Kagent MCP CLI tool

Infrastructure Requirements

Before deploying the MCP server, you need a working multi-cluster Kubernetes environment with Nephio and 5G OAI stack.

🏗️ Infrastructure Setup

Step 1: Bootstrap Kubernetes Clusters with Nephio

Follow the step-by-step guide to set up your multi-cluster Kubernetes infrastructure with Nephio:

📖 Guide: Nephio Test Infrastructure Setup

This will provision:

• Management cluster with Nephio control plane
• Workload clusters (Core, Edge, Regional, Standby)
• GitOps infrastructure (Gitea, ArgoCD)
• Porch package orchestrator

Step 2: Deploy 5G OAI Stack

Deploy the OpenAirInterface 5G network functions across your workload clusters:

📖 Guide: OAI 5G Deployment

Cluster Topology:

| Cluster | Network Functions | Description | |---------|-------------------|-------------| | Core Cluster | AMF, SMF, NRF, UDM, UDR, AUSF, MySQL | 5G Core control plane functions | | Edge Cluster | UPF, CU-UP, DU | User plane and RAN lower layers | | Regional Cluster | CU-CP | RAN control plane (gNB-CU-CP) | | Standby Cluster | (Reserved) | Target for CU-CP relocation |

Interface Bindings:

┌─────────────────┐     N2      ┌─────────────────┐
│   Core Cluster  │◄───────────►│ Regional Cluster│
│  (AMF, SMF...)  │             │    (CU-CP)      │
└────────┬────────┘             └───────┬─────────┘
         │ N4                      E1   │   F1-C
         │                              │
         ▼                              ▼
┌─────────────────────────────────────────────────┐
│                  Edge Cluster                    │
│  ┌─────┐    N3    ┌───────┐   F1-U   ┌─────┐   │
│  │ UPF │◄────────►│ CU-UP │◄────────►│ DU  │   │
│  └─────┘          └───────┘          └─────┘   │
└─────────────────────────────────────────────────┘

• N2: AMF ↔ CU-CP (NGAP signaling)
• N4: SMF ↔ UPF (PFCP session management)
• N3: UPF ↔ CU-UP (GTP-U user plane)
• E1: CU-CP ↔ CU-UP (E1AP)
• F1-C: CU-CP ↔ DU (F1AP control plane)
• F1-U: CU-UP ↔ DU (F1-U user plane)

Step 3: Install Kagent

Install Kagent for Kubernetes-native agent runtime:

# Add Kagent Helm repository
helm repo add kagent https://kagent-dev.github.io/kagent/
helm repo update

# Install Kagent in the management cluster
helm install kagent kagent/kagent \
  --namespace kagent-system \
  --create-namespace

Verify installation:

kubectl get pods -n kagent-system

📦 Installation

Option 1: Local Development

1. Clone the repository:

   git clone https://github.com/bactp/nfreconfig-mcp-server.git
   cd nfreconfig-mcp-server
   

2. Install dependencies:

   go mod tidy
   

3. Run the MCP server locally:

   go run cmd/server/main.go
   

Option 2: Docker Build

# Build using kmcp
kmcp build

# Or build manually
docker build -t nfreconfig-mcp-server:latest .

Option

... View full README on GitHub