Stk MCP

🚀 STK-MCP サーバー

STK-MCP は、Model Context Protocol (MCP) に基づくサーバーで、Lockheed Martin の STK（Satellite ToolKit）デスクトップアプリケーションを制御および自動化するために使用されます。このサーバーは、MCP プロトコルを介して STK との相互作用を可能にし、シナリオの作成や衛星の追加などのタスクを実行します。

🚀 クイックスタート

STK-MCP は、Model Context Protocol (MCP) を利用して、Lockheed Martin の STK デスクトップアプリケーションを制御および自動化するサーバーです。MCP プロトコルを通じて STK とやり取りし、シナリオ作成や衛星追加などの操作が可能です。

✨ 主な機能

• 自動制御: MCP インターフェースを介して STK デスクトップ版をリモートで制御します。
• シナリオ設定: 新しい STK シナリオを作成および構成し、開始時間と持続時間を指定できます。
• 衛星管理: 近地点、遠地点、昇交点、傾斜角などの特定の軌道パラメータを持つ衛星を追加します。

📦 インストール

前提条件

1. Python 3.12 以上をインストールします。
2. STK デスクトップ版をダウンロードしてインストールします（ライセンスが必要）。
3. システムに pywin32 ライブラリがインストールされていることを確認します（Windows では自動的に処理されます）。

手順

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/stk-mcp.git
   cd stk-mcp
   

2. 依存関係をインストールします：

   pip install -r requirements.txt
   

3. サーバーを起動します：

   python server.py
   

💻 使用例

基本的な使用法

MCP ツール

setup_scenario

• 説明: STK シナリオを作成または構成し、既存のシナリオを閉じます。
• パラメータ:
  • scenario_name (str): シナリオ名。デフォルトは "MCP_STK_Scenario"。
  • start_time (str): 開始時間。デフォルトは "20 Jan 2020 17:00:00.000"。
  • duration_hours (float): 持続時間（時間）。デフォルトは 48.0。

create_satellite

• 説明: アクティブなシナリオがあると仮定して、STK 衛星を作成または変更します。
• パラメータ:
  • name (str): 衛星名。
  • apogee_alt_km (float): 遠地点高度（キロメートル）。
  • perigee_alt_km (float): 近地点高度（キロメートル）。
  • raan_deg (float): 昇交点経度（度）。
  • inclination_deg (float): 傾斜角（度）。

高度な使用法

1. サーバーを起動した後、MCP チェッカーの URL（例: http://127.0.0.1:8765）を開きます。
2. "STK Control" サーバーを見つけます。
3. ツールセクションで setup_scenario と create_satellite を実行します。

📚 ドキュメント

将来の開発

• 地上位置の追加: 施設や地点オブジェクトを追加するための MCP ツールを追加します。
• リソースエンドポイント: STK の状態を照会するための MCP リソース（例: get_scenario_details、list_objects）を追加します。
• 衛星定義の強化: より包括的な衛星構成オプションを提供します。
• 分析ツールアクセス: オブジェクト間のアクセスを計算して報告する機能を実装します。
• エラー処理: MCP クライアントへのエラー報告を改善します。

依存関係

• agi.stk12: STK デスクトップ版との相互作用に使用されます（STK から手動でインストールする必要があります）。
• mcp[cli]>=1.6.0: Model Context Protocol ライブラリ。
• pywin32: Windows で自動的にインストールされ、COM 相互作用に使用されます。

制限事項

• Windows のみ: STK デスクトップ版の COM 自動化に大きく依存しています。
• STK デスクトップ版が必要: 現在、STK エンジンはサポートされていません。
• 基本機能: 現在はシナリオ設定と基本的な衛星作成に限定されています。
• 単一シナリオの焦点: setup_scenario ツールで管理される単一のアクティブなシナリオとの相互作用を想定しています。

🤝 貢献

貢献を歓迎します！ガイドについては CONTRIBUTING.md を参照してください。