mcp stl
   
MCP服务器,用于编辑STL 3D模型文件。提供通过模型上下文协议解析、查看和操纵STL文件的工具。
安装
pip install mcp-stlMCP服务器
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/