德蒙哥马利40_mcp-3D打印机服务器

Name: 德蒙哥马利40_mcp-3D打印机服务器
Author: MCP-Mirror

作者：MCP-Mirror13 星标更新：2025-05-14

安装使用来源：spider==github.com

项目介绍

MCP 3D打印机服务器

描述

这是一个允许MCP用户连接到这些3D打印机API端点的服务器：

OctoPrint
Klipper（Moonraker）
Duet
Repetier
Bambu Labs
Prusa Connect
Creality/Ender

此服务器是一个模型上下文协议（MCP）服务器，用于连接Claude与3D打印机管理系统。它允许Claude通过各种打印机管理系统的API（如OctoPrint、Klipper（通过Moonraker）、Duet、Repetier和Bambu Labs打印机）与3D打印机进行交互。

关于资源使用说明：此MCP服务器包括高级3D模型操作功能，在处理大型STL文件时可能会占用大量内存。请参阅“限制和注意事项”部分以获取有关内存使用和性能的重要信息。

功能

获取打印机状态（温度、打印进度等）
列出打印机上的文件
将G代码文件上传到打印机
开始、取消和监控打印作业
设置打印机温度
高级STL文件操作：
- 延伸底座以获得更好的粘附性
- 沿特定轴均匀或非均匀缩放模型
- 绕任何轴旋转模型
- 移动（平移）模型
- 修改STL文件的特定部分（顶部、底部、中心或自定义）
全面的STL分析，提供详细的模型信息
生成多角度的STL文件SVG可视化图
长时间操作的实时进度报告
错误处理及详细诊断
切片STL文件以生成G代码
确认G代码文件中的温度设置
完整的工作流程，从STL修改到打印

安装

先决条件

Node.js 18或更高版本
npm 或 yarn

从npm安装

npm install -g mcp-3d-printer-server

从源码安装

git clone https://github.com/yourusername/mcp-3d-printer-server.git
cd mcp-3d-printer-server
npm install
npm link  # 使命令全局可用

配置

在运行服务器的目录中创建一个.env文件或设置环境变量：

# 用于与您的打印机管理系统进行身份验证
API_KEY=your_api_key_here

# 默认打印机连接设置
PRINTER_HOST=localhost
PRINTER_PORT=80
PRINTER_TYPE=octoprint  # 选项：octoprint, klipper, duet, repetier, bambu

# 可选：临时文件目录
TEMP_DIR=/path/to/temp/dir

# Bambu Labs特定配置
BAMBU_SERIAL=your_printer_serial
BAMBU_TOKEN=your_access_token

# 切片器配置
SLICER_TYPE=prusaslicer  # 选项：prusaslicer, cura, slic3r
SLICER_PATH=/path/to/slicer/executable
SLICER_PROFILE=/path/to/slicer/profile

使用Claude Desktop

编辑您的Claude Desktop配置文件：

{
  "mcpServers": {
    "3dprint": {
      "command": "mcp-3d-printer-server",
      "env": {
        "API_KEY": "your_api_key_here",
        "PRINTER_HOST": "your_printer_ip",
        "PRINTER_TYPE": "octoprint"
      }
    }
  }
}

对于Bambu Labs打印机：

{
  "mcpServers": {
    "3dprint": {
      "command": "mcp-3d-printer-server",
      "env": {
        "PRINTER_HOST": "your_printer_ip",
        "PRINTER_TYPE": "bambu",
        "BAMBU_SERIAL": "your_printer_serial",
        "BAMBU_TOKEN": "your_access_token"
      }
    }
  }
}

重启Claude Desktop
通过Claude连接到您的打印机

支持的打印机管理系统

OctoPrint

OctoPrint是一款流行的3D打印机网络界面。它提供了控制打印机的REST API。

默认端口：80（http）或443（https）
身份验证：需要API密钥

Klipper（通过Moonraker）

Klipper是一款适用于3D打印机的固件，与Moonraker API服务器一起工作。

默认端口：7125
身份验证：取决于您的Moonraker配置

Duet

Duet是3D打印机的控制板，有自己的网络界面（DuetWebControl）。

默认端口：80（http）或443（https）
身份验证：取决于您的Duet配置

Repetier

Repetier-Server是3D打印机的主机软件。

默认端口：3344
身份验证：需要API密钥

Bambu Labs

Bambu Lab打印机使用MQTT进行状态和控制，并使用FTP进行文件操作。

身份验证：需要序列号和访问令牌
要求：打印机必须在同一网络上或启用云连接
兼容：X1C、P1S、P1P、A1及其他Bambu Lab打印机

查找您的Bambu打印机的序列号和访问令牌

要连接到您的Bambu Lab打印机，您需要两样东西：

打印机序列号：
- 在打印机背面或底部查找贴有序列号的标签（通常以“01P”或“01A”开头，后跟数字/字母）
- 或者打开Bambu Studio，连接到您的打印机，转到设备 > 设备管理，查看您的打印机信息
访问令牌：
- 访问令牌是直接连接到您的打印机所需的加密代码
- 对于P1系列打印机：进入触摸屏，选择设置 > 网络 > LAN模式，您会看到访问代码
- 对于X1系列打印机：进入触摸屏，选择设置 > 网络 > LAN模式，启用LAN模式以查看访问代码
- 对于A1 Mini：使用Bambu Handy应用程序连接到您的打印机，然后转到设置 > 网络 > LAN模式

注意：如果您的打印机不在同一本地网络上或找不到访问令牌，您可能需要更新打印机的固件到最新版本以启用LAN模式。

Prusa Connect

Prusa Connect是Prusa自己的基于云的解决方案，用于管理他们的打印机。

默认端口：80（http）或443（https）
身份验证：需要API密钥
兼容：Prusa MK4、Prusa Mini、Prusa XL及其他具有Prusa Connect的Prusa打印机

设置Prusa Connect

确保您的Prusa打印机已更新到最新固件
将您的打印机连接到Wi-Fi网络
创建一个Prusa Connect账户并注册您的打印机
从Prusa Connect Web界面的设置 > API访问中生成一个API密钥

Creality Cloud

Creality Cloud是Creality为其打印机提供的管理系统。

默认端口：80（http）或443（https）
身份验证：需要Bearer令牌
兼容：Ender系列、CR系列及其他具有网络功能的Creality打印机

设置Creality Cloud

在您的移动设备上安装Creality Cloud应用程序
创建一个账户并添加您的打印机
启用打印机的本地网络访问
从Creality Cloud应用程序的设置 > 开发者选项中生成一个令牌

可用工具

STL操作工具

内存使用警告：以下STL操作工具加载整个3D模型到内存中。对于大型或复杂的STL文件（>10MB），这些操作可能会消耗大量内存。在MCP环境中使用这些工具时，请注意内存限制。

get_stl_info

获取STL文件的详细信息，包括尺寸、顶点数和边界框。

{
  "stl_path": "/path/to/file.stl"
}

extend_stl_base

扩展STL文件的底座指定的量。

{
  "stl_path": "/path/to/file.stl",
  "extension_inches": 2
}

scale_stl

沿特定轴均匀或非均匀缩放STL模型。

{
  "stl_path": "/path/to/file.stl",
  "scale_factor": 1.5
}

或者非均匀缩放：

{
  "stl_path": "/path/to/file.stl",
  "scale_x": 1.2,
  "scale_y": 1.0,
  "scale_z": 1.5
}

rotate_stl

绕特定轴旋转STL模型（以度为单位）。

{
  "stl_path": "/path/to/file.stl",
  "rotate_x": 45,
  "rotate_y": 0,
  "rotate_z": 90
}

translate_stl

沿特定轴移动STL模型（以毫米为单位）。

{
  "stl_path": "/path/to/file.stl",
  "translate_x": 10,
  "translate_y": 5,
  "translate_z": 0
}

modify_stl_section

对STL文件的选定部分应用特定变换。这允许对模型的特定部分进行详细修改。

{
  "stl_path": "/path/to/file.stl",
  "section": "top",
  "transformation_type": "scale",
  "value_x": 1.5,
  "value_y": 1.5, 
  "value_z": 1.5
}

对于自定义部分边界：

{
  "stl_path": "/path/to/file.stl",
  "section": "custom",
  "transformation_type": "rotate",
  "value_x": 0,
  "value_y": 0, 
  "value_z": 45,
  "custom_min_x": -10,
  "custom_min_y": 0,
  "custom_min_z": -10,
  "custom_max_x": 10,
  "custom_max_y": 20,
  "custom_max_z": 10
}

generate_stl_visualization

从多个角度（正面、侧面、顶部和等角视图）生成STL文件的SVG可视化图。

{
  "stl_path": "/path/to/file.stl",
  "width": 400,
  "height": 400
}

slice_stl

切片STL文件以生成G代码。

{
  "stl_path": "/path/to/file.stl",
  "slicer_type": "prusaslicer",
  "slicer_path": "/path/to/prusaslicer",
  "slicer_profile": "/path/to/profile.ini"
}

confirm_temperatures

确认G代码文件中的温度设置。

{
  "gcode_path": "/path/to/file.gcode",
  "extruder_temp": 200,
  "bed_temp": 60
}

process_and_print_stl

处理STL文件（扩展底座），切片，确认温度并开始打印。

{
  "stl_path": "/path/to/file.stl",
  "extension_inches": 2,
  "extruder_temp": 200,
  "bed_temp": 60,
  "host": "192.168.1.100",
  "type": "octoprint",
  "api_key": "YOUR_API_KEY"
}

打印机控制工具

get_printer_status

获取3D打印机的当前状态。

{
  "host": "192.168.1.100",
  "type": "octoprint",
  "api_key": "YOUR_API_KEY"
}

对于Bambu打印机：

{
  "host": "192.168.1.100",
  "type": "bambu",
  "bambu_serial": "YOUR_PRINTER_SERIAL",
  "bambu_token": "YOUR_ACCESS_TOKEN"
}

list_printer_files

列出打印机上可用的文件。

{
  "host": "192.168.1.100",
  "type": "octoprint",
  "api_key": "YOUR_API_KEY"
}

upload_gcode

将G代码文件上传到打印机。

{
  "host": "192.168.1.100",
  "type": "octoprint",
  "api_key": "YOUR_API_KEY",
  "filename": "my_print.gcode",
  "gcode": "G28\nG1 X100 Y100 Z10 F3000\n...",
  "print": true
}

start_print

开始打印已经存在于打印机上的文件。

{
  "host": "192.168.1.100",
  "type": "octoprint",
  "api_key": "YOUR_API_KEY",
  "filename": "my_print.gcode"
}

cancel_print

取消当前打印作业。

{
  "host": "192.168.1.100",
  "type": "octoprint",
  "api_key": "YOUR_API_KEY"
}

set_printer_temperature

设置打印机组件的温度。

{
  "host": "192.168.1.100",
  "type": "octoprint",
  "api_key": "YOUR_API_KEY",
  "component": "extruder",
  "temperature": 200
}

可用资源

printer://{host}/status - 3D打印机的当前状态
printer://{host}/files - 打印机上可用的文件列表
printer://{host}/file/{filename} - 打印机上特定文件的内容

示例命令给Claude

这里是一些示例命令，您可以连接MCP服务器后给Claude：

打印机控制

“我的3D打印机当前状态是什么？”
“显示我打印机上的文件列表。”
“上传这个G代码到我的打印机：[G代码内容]”
“开始打印名为'benchy.gcode'的文件。”
“取消当前打印作业。”
“将挤出机温度设置为200°C。”
“将床温设置为60°C。”

STL操作和打印

“拿这个STL文件，将其底座延长2英寸，然后发送到切片器并在我的打印机中排队。”
“将model.stl的底座延长1.5英寸。”
“将这个STL文件均匀放大150%。”
“将model.stl的宽度加倍但保持相同的高度。”
“将这个模型绕Z轴旋转90度。”
“将这个STL模型向上移动5mm以在其下方创建间隙。”
“你能修改这个模型的顶部部分使其增大20%吗？”
“分析这个STL文件并告诉我其尺寸和细节。”
“生成这个STL文件的可视化图，让我看看它的样子。”
“从不同角度生成我的模型的SVG可视化图。”
“使这个模型的底座更宽而不改变其高度。”
“使用PrusaSlicer切片修改后的STL文件。”
“确认G代码中的温度设置为挤出机200°C，床温60°C。”
“处理这个STL文件，使其底座延长2英寸，切片并开始打印，但在开始前确认温度。”

Bambu Lab打印机限制

由于Bambu Lab打印机API的性质，存在一些限制：

启动打印：启动打印需要3MF项目文件路径、G代码文件名、打印名称和MD5哈希值。此服务器中的简化API尚未完全支持这一点。
温度控制：Bambu API不提供直接设置