mcp-dd-simulation

MCP Server for DD Unity 6-DOF ballistic simulation.

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

服务提供三个工具：

• get_sim_spec：返回参数规范、经验规则和示例请求。
• preview_sim：校验仿真设计并补全默认参数，不启动仿真。
• run_sim：读取指定 JSON 文件，校验参数并执行弹道仿真。

前置条件

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

安装

uv sync
uv run mcp-dd-simulation

默认使用 stdio。如需独立 HTTP 服务：

uv run mcp-dd-simulation --transport streamable-http

默认地址为 http://127.0.0.1:8000/mcp。可用环境变量：

• MCP_HOST、MCP_PORT、MCP_TRANSPORT

Claude Code 配置

在 .claude.json 或项目的 .mcp.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"
      }
    }
  }
}

使用流程

建议先调用 get_sim_spec 获取参数规范；preview_sim 和 run_sim 只需传入 json_path，其值为仿真请求 JSON 文件路径。校验通过后再执行仿真。

仿真请求 JSON 示例

{
    "schema_version": "1.0",
    "design_conditions": {
        "scenario": "intercept",
        "description": "高空拦截"
    },
    "parameters": {
        "Target": {
            "target_position": [80000.0, 80000.0, -20000.0],
            "target_vel": [-200.0, -200.0, 0.0]
        },
        "Initial": {
            "Xme0": [0.0, 0.0, -7000.0],
            "Vme0": [400.0, 0.0, 0.0]
        }
    }
}

只填必填参数即可，其余参数由默认值自动补全。

参数分组

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