Ptp MCP Server

🚀 PTP MCP Server

PTP MCP Server 是一個模型上下文協議（MCP）服務器，用於在 OpenShift 集群中監控和分析精確時間協議（PTP）系統。它能幫助用戶更好地管理和維護 PTP 系統，確保時間同步的準確性和穩定性。

🚀 快速開始

前提條件

• Python 3.8 或更高版本
• 安裝並配置好 OpenShift CLI (oc)
• 能夠訪問已安裝 PTP 運算符的 OpenShift 集群
• 存在 PTP 命名空間 (openshift-ptp)

安裝步驟

1. 克隆倉庫：

   git clone https://github.com/aneeshkp/ptp-mcp-server.git
   cd ptp-mcp-server
   

2. 安裝依賴項：

   pip install -r requirements.txt
   

3. 驗證 OpenShift 訪問權限：

   oc whoami
   oc get namespace openshift-ptp
   

快速測試

運行綜合測試套件：

python quick_test.py

預期輸出：

🔍 PTP MCP Server API Quick Test
==================================================
Tests Passed: 8/8
Success Rate: 100.0%
🎉 ALL TESTS PASSED! Your API is ready for agent integration.

啟動 MCP 服務器

啟動 MCP 服務器以與支持 MCP 的客戶端集成：

python ptp_mcp_server.py

✨ 主要特性

• PTP 配置分析：解析並驗證來自 OpenShift 的 PTP 配置。
• 實時日誌監控：通過智能解析訪問 linuxptp 守護進程日誌。
• 自然語言查詢：使用通俗易懂的英語詢問有關 PTP 狀態的問題。
• 健康監控：對 PTP 系統進行全面的健康檢查。
• 同步分析：監控同步狀態、偏移量和最佳主時鐘算法（BMCA）狀態。
• 時鐘層次結構：跟蹤主時鐘和時鐘層次結構信息。
• ITU-T 合規性：根據 ITU-T G.8275.1 標準驗證配置。

💻 使用示例

基礎用法

基本健康檢查

import asyncio
from ptp_tools import PTPTools

async def check_health():
    tools = PTPTools()
    health = await tools.check_ptp_health({})
    
    if health["success"]:
        print(f"Status: {health['overall_status']}")
        for check_name, result in health["checks"].items():
            print(f"{check_name}: {result}")
    else:
        print(f"Error: {health.get('error')}")

asyncio.run(check_health())

自然語言查詢

async def ask_question():
    tools = PTPTools()
    response = await tools.query_ptp({
        "question": "What is the current grandmaster?"
    })
    
    if response["success"]:
        print(f"Answer: {response['response']}")
    else:
        print(f"Error: {response.get('error')}")

asyncio.run(ask_question())

日誌分析

async def analyze_logs():
    tools = PTPTools()
    
    # Get recent logs
    logs = await tools.get_ptp_logs({"lines": 500})
    
    # Search for specific events
    sync_loss = await tools.search_logs({"query": "sync loss"})
    clock_changes = await tools.search_logs({"query": "clockClass change"})
    
    print(f"Total logs: {logs['logs_count']}")
    print(f"Sync loss events: {sync_loss['matching_logs']}")
    print(f"Clock changes: {clock_changes['matching_logs']}")

asyncio.run(analyze_logs())

高級用法

服務器提供以下 MCP 工具：

• get_ptp_config - 獲取 PTP 配置
• get_ptp_logs - 獲取 linuxptp 守護進程日誌
• search_logs - 搜索日誌中的模式
• get_grandmaster_status - 獲取主時鐘信息
• analyze_sync_status - 分析同步狀態
• get_clock_hierarchy - 獲取時鐘層次結構
• check_ptp_health - 全面的健康檢查
• query_ptp - 自然語言接口

📚 詳細文檔

API 端點

1. 配置 API

from ptp_tools import PTPTools
tools = PTPTools()
result = await tools.get_ptp_config({"namespace": "openshift-ptp"})

2. 日誌 API

result = await tools.get_ptp_logs({"lines": 1000})

3. 搜索 API

result = await tools.search_logs({"query": "dpll", "time_range": "last_hour"})

4. 健康 API

result = await tools.check_ptp_health({"check_config": True, "check_sync": True})

5. 自然語言 API

result = await tools.query_ptp({"question": "What is the current grandmaster?"})

6. 主時鐘狀態 API

result = await tools.get_grandmaster_status({"detailed": True})

7. 同步狀態 API

result = await tools.analyze_sync_status({"include_offsets": True})

8. 時鐘層次結構 API

result = await tools.get_clock_hierarchy({"include_ports": True})

🔧 技術細節

性能指標

• 平均響應時間：0.78 秒
• 最快的 API：配置 API（0.22 秒）
• 併發操作：在 2.45 秒內 4/4 成功
• 成功率：100%（8/8 個端點）

架構

ptp-mcp-server/
├── ptp_mcp_server.py      # 主 MCP 服務器
├── ptp_config_parser.py   # PTP 配置解析器
├── ptp_log_parser.py      # Linuxptp 日誌解析器
├── ptp_model.py           # PTP 數據模型
├── ptp_query_engine.py    # 自然語言查詢引擎
├── ptp_tools.py           # API 端點實現
├── quick_test.py          # 快速測試套件
├── performance_test.py    # 性能基準測試
└── requirements.txt       # Python 依賴項

支持的 PTP 概念

• BMCA（最佳主時鐘算法）：時鐘選擇和層次結構
• 時鐘類型：OC（普通時鐘）、BC（邊界時鐘）、TC（透明時鐘）
• ITU-T G.8275.1：配置文件合規性和驗證
• 同步：偏移跟蹤、頻率調整、同步狀態
• 主時鐘：主要時間源識別和狀態
• 時鐘類別：質量和可追溯性指標
• 域編號：PTP 域配置（ITU-T 為 24 - 43）

🧪 測試

運行所有測試

python quick_test.py

性能測試

python performance_test.py

單個組件測試

# 測試配置解析器
python -c "from ptp_config_parser import PTPConfigParser; import asyncio; asyncio.run(PTPConfigParser().get_ptp_configs())"

# 測試日誌解析器
python -c "from ptp_log_parser import PTPLogParser; import asyncio; asyncio.run(PTPLogParser().get_ptp_logs())"

文檔

• 測試指南 - 全面的測試說明
• 代理集成指南 - 代理的集成示例
• 測試步驟 - 分步測試過程
• 測試結果 - 完整的測試結果

🤝 貢獻

1. 分叉倉庫。
2. 創建功能分支 (git checkout -b feature/amazing-feature)。
3. 提交更改 (git commit -m 'Add amazing feature')。
4. 推送到分支 (git push origin feature/amazing-feature)。
5. 打開拉取請求。

📄 許可證

本項目採用 MIT 許可證 - 有關詳細信息，請參閱 LICENSE 文件。

🙏 致謝

• OpenShift PTP 運算符團隊
• Linuxptp 項目
• 模型上下文協議（MCP）社區

📞 支持

如有問題，請：

• 在 GitHub 上創建問題。
• 查看 測試文檔。
• 查看 代理集成指南。

狀態：✅ 可用於生產
最後更新時間：2025 年 1 月
版本：1.0.0