home / mcp / ptp mcp server

PTP MCP Server

Provides an MCP server that monitors and analyzes PTP systems in OpenShift, including configuration, logs, health, and natural language queries.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "aneeshkp-ptp-mcp-server": {
      "command": "python",
      "args": [
        "ptp_mcp_server.py"
      ]
    }
  }
}

You deploy the PTP MCP Server to monitor and analyze Precision Time Protocol systems within OpenShift clusters. It provides configuration analysis, real-time log access, natural language queries, health checks, synchronization insights, clock hierarchy, and ITU-T G.8275.1 compliance validation to help you diagnose and optimize PTP deployments.

How to use

Start the MCP server to expose tools you can access from MCP clients. The server supports configuration checks, log retrieval, search capabilities, health analysis, natural language questions, grandmaster information, sync analysis, and clock hierarchy data. Connect your MCP client to the local Python process and use the provided tools to gather configuration details, review logs, run health checks, and perform on-demand queries about the PTP system.

How to install

Prerequisites you need before running the MCP server include Python 3.8 or higher, the OpenShift CLI installed and configured, access to an OpenShift cluster with the PTP operator, and the PTP namespace openshift-ptp.

# 1) Clone the server repository
git clone https://github.com/aneeshkp/ptp-mcp-server.git
cd ptp-mcp-server

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

# 3) Verify OpenShift access
oc whoami
oc get namespace openshift-ptp

Additional notes

Run the MCP server from the project’s entry point to start accepting MCP client connections. Use the Python runner to launch the server process and keep it running to serve requests from MCP clients.

python ptp_mcp_server.py

Available tools

get_ptp_config

Retrieve the current PTP configuration for the specified namespace, enabling you to validate settings and ensure consistency.

get_ptp_logs

Fetch recent linuxptp daemon logs to monitor activity, events, and potential issues.

search_logs

Search the PTP logs for patterns or events of interest to quickly locate synchronization problems or misconfigurations.

check_ptp_health

Run comprehensive health checks on the PTP system, including configuration validity and synchronization status.

query_ptp

Ask natural language questions about PTP status and receive human-readable answers.

get_grandmaster_status

Provide detailed information about the current grandmaster, including status and topology.

analyze_sync_status

Analyze synchronization status, including offsets, frequency adjustments, and BMCA state.

get_clock_hierarchy

Return the clock hierarchy and grandmaster relationships, including port-level details if requested.