mcp-stl

mcp-stl

用于编辑 STL 3D 模型文件的 MCP 服务。通过 Model Context Protocol 提供解析、查看和操作 STL 文件的工具。

安装

pip install mcp-stl

MCP 服务

mcp-name: io.github.daedalus/mcp-stl

工具

读取与写入

• read_stl_file：读取 STL 文件并返回网格数据（顶点、法线、边界框）
• get_mesh_info：获取 STL 文件的摘要信息，而不加载完整几何体
• write_stl：将网格数据写入 STL 文件（ASCII 或二进制格式）

变换

• translate_stl：按指定的 X、Y、Z 偏移量平移（移动）网格
• rotate_stl：按给定的角度（度）绕 X、Y 或 Z 轴旋转网格
• scale_stl：按指定的 X、Y、Z 比例缩放网格
• shear_stl：应用剪切变换（沿另一个轴的每个单位移动一个轴）
• mirror_stl：沿垂直于指定轴的平面镜像（反射）网格
• rotate_stl_axis：绕任意轴向量旋转网格（Rodrigues 公式）
• combine_stl：将多个 STL 文件合并为一个
• array_linear：创建 N 个网格副本，并按固定的 X/Y/Z 偏移量间隔排列
• array_circular：创建 N 个网格副本，并使其绕某个轴按相等角度间隔排列

基本几何体

• create_cube：创建立方体网格
• create_box：创建长方体网格，可分别指定宽度、高度和深度
• create_sphere：创建球体网格
• create_cylinder：创建圆柱体网格
• create_cone：创建圆锥体网格
• create_torus：创建圆环体（甜甜圈）网格
• create_plane：创建平面网格
• create_capsule：创建胶囊体（两端带半球形端盖的圆柱体）
• create_ellipsoid：创建椭球体，可分别指定各轴的半径
• create_frustum：创建截头体（截锥）
• create_tube：创建中空圆柱体（管）
• create_pyramid：创建正 n 边形棱锥
• create_prism：创建正 n 边形棱柱（例如六棱柱）
• create_hemisphere：创建半球体（带平坦圆形底面的穹顶）
• create_wedge：创建直角三角形楔体（三棱柱）

发动机设计形状

• create_gear：创建正齿轮网格（可配置模数、齿数和压力角）
• create_spring：创建螺旋弹簧
• create_connecting_rod：创建带有大端和小端孔的连杆
• create_crankshaft：创建具有 N 个曲拐的曲轴
• create_valve：创建菌形阀（阀杆 + 阀头圆盘）
• create_camshaft_lobe：创建具有余弦形鼻部轮廓的偏心凸轮凸瓣

用法

Python API

from mcp_stl import read_stl_file, create_cube, translate_stl

# Read an existing STL file
mesh = read_stl_file("model.stl")
print(f"Faces: {mesh.face_count}")

# Create a primitive
create_cube("cube.stl", size=2.0)

# Transform a mesh
translate_stl("input.stl", "output.stl", x=10.0, y=0.0, z=5.0)

MCP 服务

在 MCP 客户端中配置：

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

开发

git clone https://github.com/daedalus/mcp-stl.git
cd mcp-stl
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/