内容
# 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`:
=======
# 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（本机可运行）
## 快速开始
在项目目录执行：
```bash
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 配置示例
```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"
}
}
}
```
