AI导哈

STL文件编辑工具

一个提供STL 3D模型文件解析、查看和编辑功能的服务器工具，支持多种几何变换和基本形状生成。

  • by daedalus
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 daedalus/mcp-stl

使用说明

mcp stl

MCP服务器，用于编辑STL 3D模型文件。提供通过模型上下文协议解析、查看和操纵STL文件的工具。

安装

pip install mcp-stl

MCP服务器

mcp名称：io.github.daedalus/mcp-stl

工具

阅读与写作

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

变换

  • translate_stl：按指定的X、Y、Z偏移量平移（移动）网格
  • rotate_stl：将网格围绕X、Y或Z轴旋转给定角度（度）
  • scale_tl：按指定的X、Y、Z因子缩放网格
  • shear_stl：应用剪切变换（每个单元沿另一个轴移动一个轴）
  • mirror_str：在垂直于给定轴的平面上镜像（反射）网格
  • rotate_stl_轴：围绕任意轴矢量旋转网格（Rodrigues公式）
  • combine_stl：将多个STL文件合并为一个
  • array_line：以固定的X/Y/Z偏移间隔创建N个网格副本
  • array_circular：围绕轴以相等的角度间隔创建N个网格副本

原语

  • 创建多维数据集：创建立方体网格
  • create_box：创建一个具有独立宽度/高度/深度的矩形框（长方体）
  • create_sphere：创建球体网格
  • create_clinder：创建圆柱体网格
  • create_cone：创建圆锥体网格
  • create_torus：创建圆环（甜甜圈）网格
  • create_plane：创建平面网格
  • create_capsule：创建胶囊（带有半球形端盖的圆柱体）
  • create_ellipsoid：在每个轴上创建具有独立半径的椭球体
  • create_frustum：创建截头圆锥体
  • create_tube：创建空心圆柱体（管/管）
  • create_pyramid：创建规则的n边棱锥体
  • create_prism：创建规则的n边棱镜（例如六角棱镜）
  • 创建大气层：创建半球体（带平坦圆形底座的圆顶）
  • 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/

相关 MCP