Stk MCP

🚀 STK-MCP 服務器

STK-MCP 是基於 Model Context Protocol (MCP) 的服務器，可控制並自動化 Lockheed Martin 的 STK（Satellite ToolKit）桌面應用程序。藉助 MCP 協議，它能與 STK 交互，完成創建場景、添加衛星等任務。

🚀 快速開始

STK-MCP 服務器讓你可以通過 MCP 協議與 STK 進行交互。以下是快速上手的步驟：

# 克隆倉庫
git clone https://github.com/yourusername/stk-mcp.git
cd stk-mcp

# 安裝依賴項
pip install -r requirements.txt

# 啟動服務器
python server.py

✨ 主要特性

• 自動化控制：通過 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
   

💻 使用示例

基礎用法

啟動服務器後，可按以下步驟操作：

1. 打開 MCP 檢查器 URL（例如：http://127.0.0.1:8765）。
2. 找到 "STK Control" 服務器。
3. 在工具部分執行 setup_scenario 和 create_satellite。

高級用法

以下是 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)：傾角（度）。

📚 詳細文檔

未來開發

• 添加地面位置：增加 MCP 工具以添加設施或地點對象。
• 資源端點：添加 MCP 資源（例如 get_scenario_details、list_objects）以查詢 STK 狀態。
• 增強衛星定義：提供更全面的衛星配置選項。
• 分析工具訪問：實現計算和報告對象間訪問的功能。
• 錯誤處理：提升錯誤報告到 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 以獲取指南。