Ptp MCP Server

🚀 PTP MCP Server

OpenShiftクラスタ内のPrecision Time Protocol (PTP) システムを監視および分析するためのModel Context Protocol (MCP) サーバーです。

🚀 クイックスタート

このサーバーは、OpenShiftクラスタ内のPTPシステムの監視と分析を行います。以下の手順でセットアップして使用できます。

✨ 主な機能

• PTP構成分析：OpenShiftからのPTP構成を解析して検証します。
• リアルタイムログ監視：linuxptpデーモンのログにアクセスし、インテリジェントな解析を行います。
• 自然言語クエリ：PTPの状態に関する質問を平易な英語で行えます。
• ヘルスモニタリング：包括的なPTPシステムのヘルスチェックを行います。
• 同期分析：同期状態、オフセット、およびBMCA状態を監視します。
• クロック階層：グランドマスターとクロックの階層情報を追跡します。
• ITU-T準拠：ITU-T G.8275.1標準に対して構成を検証します。

📦 インストール

前提条件

• 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
   

💻 使用例

基本的な使用法

基本的なヘルスチェック

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互換クライアントとの統合のためにMCPサーバーを起動します。

python ptp_mcp_server.py

サーバーは以下の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})

テスト

すべてのテストを実行する

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.

パフォーマンステスト

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())"

その他のドキュメント

• テストガイド - 包括的なテスト手順
• エージェント統合ガイド - エージェントの統合例
• テスト手順 - ステップバイステップのテストプロセス
• テスト結果 - 完全なテスト結果

🔧 技術詳細

パフォーマンス

• 平均応答時間：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 (Best Master Clock Algorithm)：クロックの選択と階層
• クロックタイプ：OC (Ordinary Clock)、BC (Boundary Clock)、TC (Transparent Clock)
• ITU-T G.8275.1：プロファイルの準拠と検証
• 同期：オフセット追跡、周波数調整、同期状態
• グランドマスター：主要な時間ソースの識別と状態
• クロッククラス：品質とトレーサビリティの指標
• ドメイン番号：PTPドメインの構成 (ITU-Tの場合は24 - 43)

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。

🙏 謝辞

• OpenShift PTPオペレーターチーム
• Linuxptpプロジェクト
• Model Context Protocol (MCP) コミュニティ

📞 サポート

問題や質問については、以下の方法で対応します。

• GitHubでイシューを作成する
• テストドキュメント を確認する
• エージェント統合ガイド を確認する

ステータス：✅ 本番環境での使用可
最終更新日：2025年1月
バージョン：1.0.0