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

pip install -e .

Or install dependencies directly:

pip install mcp

Usage

Running the server

# 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:

AFSIM MCP

本项目是一个本地 MCP 服务器，用于把 AFSIM 能力接入支持 MCP 的客户端（如 Cursor、Claude Desktop、VS Code、Trae、OpenCode 等）。

仓库只包含 MCP 服务源码与配置脚本，不附带测试工程、测试数据、示例生成产物或本地运行状态。实际使用时，请把 AFSIM 工程目录通过配置指向你自己的 project_root。

如需给大模型或团队成员提供统一项目背景与建模建议，可参考仓库中的 memory.md。 如需评估当前项目真实能力边界，可参考 CAPABILITY_ASSESSMENT.md；如需约束接入大模型的标准工作流，可参考 MODEL_WORKFLOW_PROMPT.md。

前置条件

• Windows
• Python 3.10+
• 已安装 AFSIM（本机可运行）

快速开始

在项目目录执行：

python configure_mcp.py

脚本会按提示询问并写入本地配置，同时输出客户端所需的 MCP 配置片段。

配置项说明

• AFSIM 根目录：AFSIM 安装目录
• AFSIM 项目目录：你的 AFSIM 工程目录
• AFSIM demos 目录：官方示例目录
• AFSIM bin 目录：mission.exe 等可执行文件所在目录
• 配置文件存放目录：默认 C:\Users\你的用户名\.afsim_mcp
• 运行时状态目录：默认 project_root\mcp_state；客户端通常只需要传入 AFSIM_MCP_CONFIG_DIR 用于定位配置文件，如需覆盖状态目录可额外设置 AFSIM_MCP_STATE_DIR

如果检测到已有配置，脚本会显示旧值；直接回车表示保留旧值。

客户端配置

脚本会输出两段内容：

1. 通用连接信息
2. 你选择的平台对应的 JSON 配置示例

{
  "mcpServers": {
    "afsim": {
      "command": "afsim-mcp"
    }
  }
}

Or if not installed:

{
  "mcpServers": {
    "afsim": {
      "command": "python",
      "args": ["-m", "afsim_mcp.server"],
      "cwd": "/path/to/AFSIM_MCP"
    }
  }
}