Metadata-Version: 2.4
Name: yudeshi1314520-mcp-dd-simulation
Version: 0.1.0
Summary: MCP Server for DD Unity 6-DOF ballistic simulation
License-Expression: MIT
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0
Description-Content-Type: text/markdown

# mcp-dd-simulation

MCP Server for DD Unity 6-DOF ballistic simulation.

通过 MCP 协议调用 DD_Unity.exe 弹道仿真引擎，支持 Claude Code、Claude Desktop 等任何兼容 MCP 的 AI 客户端。

## 前置条件

1. 将 `DD_Unity.exe` 放在本地（需包含 `--run-once` 模式）
2. 设置环境变量 `DD_UNITY_EXE_PATH` 指向 EXE 路径

## 安装

```bash
# 通过 uvx 临时运行（推荐）
uvx --from yudeshi1314520-mcp-dd-simulation mcp-dd-simulation
```

## Claude Code 配置

在 `.claude.json` 或项目的 `.mcp.json` 中添加：

```json
{
  "mcpServers": {
    "dd-simulation": {
      "command": "uvx",
      "args": ["--from", "yudeshi1314520-mcp-dd-simulation", "mcp-dd-simulation"],
      "env": {
        "DD_UNITY_EXE_PATH": "D:\\弹道联合Unity仿真\\Unity\\DD_UnityQ\\DD_app\\DD_Unity.exe"
      }
    }
  }
}
```

## 参数

所有参数均可选，使用默认值：

| 分组 | 参数 | 类型 | 默认值 | 说明 |
|------|------|------|--------|------|
| 仿真 | simTime | number | 2.0 | 仿真时长（秒） |
| 仿真 | speedUp | int | 10 | 速度倍率 |
| 仿真 | killDistance | number | 50.0 | 命中距离（m） |
| 仿真 | export_csv | bool | false | 导出 CSV |
| 物理 | Mg | number | 300.0 | 质量（kg） |
| 物理 | Sref | number | 0.10787 | 参考面积 |
| 物理 | Lref | number | 3.6 | 参考长度 |
| 物理 | XG | number | 0.5 | 重心 |
| 初始 | Vme0 | [3] | [400,0,0] | 初速 (m/s) |
| 初始 | Xme0 | [3] | [0,0,-7000] | 初始位置 (m) |
| 目标 | target_position | [3] | [80000,80000,-20000] | 目标位置 (m) |
| 目标 | target_vel | [3] | [-200,-200,0] | 目标速度 (m/s) |
| 增益 | Kp_* / Ki_* | number | 见代码 | P/I 控制器增益 |

坐标系：NED（北-东-地），X=北，Y=东，Z=下（-Z=高度）。
