math_graphics/
├── core/
│   ├── canvas.py          # SVGCanvas: 点、线、虚线、折角、圆弧、数学字体标注
│   ├── projection.py      # StereoEngine: 斜二测画法 (Axonometric) 3D -> 2D 投影
│   └── renderer.py        # Swift/AppKit 原生 300+ DPI 印刷级 PNG 光栅化渲染
├── models/
│   ├── solids.py          # 标准多面体：正方体/长方体(任意截面)、三棱柱、四棱锥、自定义几何体
│   ├── complex_solids.py  # 复合多面体：异形翻折四面体、截角八面/正方体
│   ├── plane.py           # 平面：向量加减/数量积、正弦外接圆、立体几何 8 大核心定理
│   ├── stats.py           # 统计与概率：频率分布直方图、正态分布密度曲线、古典概型树状图
│   └── physics.py         # 物理模型：v-t 图、伏安特性曲线、带电粒子偏转轨迹
├── cli.py                 # 统一命令行入口 (CLI)
├── mcp_server.py          # MCP 标准服务端 (JSON-RPC 2.0 over stdio)
├── examples/              # 高清样例矢量图与渲染图
├── scripts/               # 批量生成全图库辅助脚本
└── tests/
    └── test_encapsulation.py # 自动化测试套件

git clone https://github.com/ZHUOLIN0928/math-graphics.git
cd math-graphics
pip install -e .

# 生成正方体并绘制截面 A-C-C1-A1，同时输出高清 PNG
math-graphics solid --shape cube --section A,C,C1,A1 --png -o cube_cut.svg

# 生成直三棱柱
math-graphics solid --shape prism --png -o tri_prism.svg

# 生成正四棱锥 P-ABCD
math-graphics solid --shape pyramid --png -o pyramid.svg

# 向量加法 (平行四边形法则)
math-graphics plane --type vector-add --png -o vec_add.svg

# 正弦定理与外接圆模型
math-graphics plane --type triangle-sine --png -o triangle_sine.svg

# 生成二面角平面角模型 (geo_07)
math-graphics theorem --id geo_07 --png -o dihedral.svg

math-graphics batch-all -d ./output_figures

{
  "mcpServers": {
    "math-graphics": {
      "command": "math-graphics-mcp"
    }
  }
}

from math_graphics import build_cube, render_svg_to_png

# 1. 构造带截面正方体模型
cv = build_cube(
    a=1.5, b=1.8, c=1.8,
    section=["A", "C", "C1", "A1"],
    title="正方体对角面截面模型"
)
svg_path = cv.save("cube_section.svg")

# 2. 渲染为 300+ DPI 印刷级 PNG
png_path = render_svg_to_png(svg_path, scale=3.0)
print(f"印刷级图像已生成: {png_path}")