STK-MCP
by alti3
STK-MCP is an MCP server that enables Large Language Models (LLMs) or other MCP clients to interact with Ansys/AGI STK (Systems Tool Kit). It allows controlling STK Desktop via MCP tools, leveraging the STK Python API.
Last updated: N/A
What is STK-MCP?
STK-MCP is an MCP server designed to bridge the gap between programmatic or natural language interaction (via LLMs) and the powerful simulation capabilities of STK. It exposes STK functionalities through an MCP server, allowing users to command STK simulations using MCP clients or potentially LLM-driven applications.
How to use STK-MCP?
To use STK-MCP, first ensure you have the prerequisites installed, including Windows, Python 3.12+, Ansys/AGI STK 12.x Desktop, and the STK Python API. Clone the repository, install project dependencies using uv sync, and then run the MCP server using either python scripts/run_dev.py or mcp dev src/stk_mcp/server.py. Interact with the server using an MCP client like MCP Inspector to execute tools like setup_scenario and create_satellite.
Key features of STK-MCP
MCP Server Implementation using FastMCP
Modular Structure with server setup, STK interaction logic, and MCP tools
STK Desktop Integration: Automatically connects to or starts STK 12 (requires Windows)
Scenario Management Tool (setup_scenario): Creates new scenarios and sets analysis time periods
Satellite Creation Tool (create_satellite): Adds Satellite objects to the currently active scenario
Orbit Definition: Configures satellite orbits using Apogee/Perigee Altitude, RAAN, and Inclination
TwoBody Propagation: Sets up and runs the TwoBody propagator for created satellites
Use cases of STK-MCP
Controlling STK simulations programmatically
Interacting with STK using natural language via LLMs
Automating STK scenario setup and satellite creation
Integrating STK with other MCP-compatible systems
FAQ from STK-MCP
What operating systems are supported?
What operating systems are supported?
Currently, only Windows is supported due to STK Desktop and win32com dependency.
Does it support STK Engine?
Does it support STK Engine?
No, it currently only supports STK Desktop.
What is the purpose of the setup_scenario tool?
What is the purpose of the setup_scenario tool?
The setup_scenario tool creates and configures an STK scenario, closing any existing scenario first.
How do I install the STK Python API?
How do I install the STK Python API?
Locate the agi.stk12-py3-none-any.whl file within your STK installation directory and install it using pip: uv pip install path/to/agi.stk12-py3-none-any.whl
How do I run the MCP server?
How do I run the MCP server?
Run the MCP server using either python scripts/run_dev.py or mcp dev src/stk_mcp/server.py from the project root.