Ankita-Mandal/mcp-ue-server

UE MCP Server

Overview

The UE MCP (Model Context Protocol) Server provides a standardized interface for controlling and monitoring 5G User Equipment (UE) modems. It enables programmatic access to UE functionality through a set of well-defined tools and resources, facilitating integration with automated testing frameworks, network monitoring systems, and research applications.

Features

UE Connection Management

• Initialize UE Connection: Establish communication with UE modems via serial ports
• Close UE Connection: Safely terminate connections to UE modems
• Check Port Availability: Verify if specified COM ports are available for connection

Radio Control

• Enable/Disable Radio: Control UE radio functionality
• Reset Modem: Perform hardware reset of the UE modem
• Get Modem Information: Retrieve device identification and capabilities

Network Configuration

• Update UE Configuration: Configure network parameters including:
  • Network mode preferences (NR5G, LTE, etc.)
  • Band configuration for different radio access technologies
  • Service domain settings

Network Monitoring

• Get UE Logs: Retrieve comprehensive logs including:
  • Serving cell information
  • Connection state (SEARCH, LIMSRV, NOCONN)
  • Signal quality metrics (RSRP, RSRQ, SINR)
  • Cell identification parameters

Documentation Access

• Search AT Commands: Query the AT command documentation for specific commands or terms
• Get 3GPP Documentation: Access 3GPP specifications with section-specific retrieval

Resources

• AT Commands Documentation: Complete reference for supported AT commands
• Action Log: Record of all actions performed by the server

Workflow Prompts

The server includes predefined workflow prompts to assist with common tasks:

• Setup UE Connection: Initialize modem, cycle power, and check status
• Troubleshoot UE Connection: Step-by-step process for diagnosing and resolving connection issues

Technical Details

Architecture

The server follows a modular architecture with clear separation of concerns:

• Server Layer: Handles MCP protocol communication and exposes tools/resources
• Command Layer: Manages AT command execution and communication with the UE
• Helper Layer: Provides parsing and formatting functions for UE responses

Dependencies

• Python 3.8+
• FastMCP framework
• PyPDF2 (for documentation features)
• PySerial (for UE communication)

Getting Started

1. Install required dependencies: pip install -r requirements.txt
2. Configure UE connection parameters in the server
3. Run the server: python server.py
4. Connect to the server using an MCP client