Content
# AFSIM MCP Server
MCP (Model Context Protocol) server for the **Advanced Framework for Simulation, Integration, and Modeling (AFSIM)**. Enables LLMs and AI agents to interact with AFSIM through standardized tools.
## Features
| Category | Tools |
|---|---|
| **Scenario Management** | `create_scenario`, `load_scenario`, `save_scenario`, `validate_scenario`, `list_scenarios`, `delete_scenario`, `get_scenario_content`, `list_scenario_files` |
| **Entity & Component Management** | `create_platform`, `delete_platform`, `modify_platform`, `list_platforms`, `add_mover`, `add_sensor`, `add_weapon`, `remove_component`, `list_components` |
| **Simulation Control** | `run_simulation`, `stop_simulation`, `get_simulation_status`, `list_simulation_runs`, `set_afsim_binary` |
| **Results Handling** | `list_result_files`, `query_csv_results`, `query_evt_results`, `query_aer_results`, `export_results_to_json`, `get_results_summary` |
| **AFSIM Backend** | `set_afsim_home`, `detect_afsim_installation`, `set_tool_binary_path`, `run_wizard`, `run_mission`, `run_warlock`, `run_mystic` |
| **Natural Language** | `generate_scenario_from_prompt`, `refine_scenario_from_prompt` |
## Installation
```bash
pip install -e .
```
Or install dependencies directly:
```bash
pip install mcp
```
## Usage
### Running the server
```bash
# Via installed CLI
afsim-mcp
# Via Python module
python -m afsim_mcp.server
```
The server uses **stdio transport** and is compatible with any MCP client (Claude Desktop, VS Code MCP extension, etc.).
### Claude Desktop configuration
Add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"afsim": {
"command": "afsim-mcp"
}
}
}
```
Or if not installed:
```json
{
"mcpServers": {
"afsim": {
"command": "python",
"args": ["-m", "afsim_mcp.server"],
"cwd": "/path/to/AFSIM_MCP"
}
}
}
```
