使用说明

重复性mcp

用于Repetier主机/Repetier服务器的MCP服务器——使用AI监控、控制和诊断您的3D打印机。

将Claude（或任何兼容MCP的AI）直接连接到您的3D打印机。获取实时温度读数、作业进度、智能错误诊断，以及打印机特定的维修指南，包括内置的知识库为了 火炮响尾蛇X1.

英文自述| 西班牙语

你能做什么

告诉克劳德。..	发生了什么
“打印机温度是多少？”	实时返回hoteld+床温
“我的打印机存在层偏移问题”	诊断原因，提供分步维修指南
“发送M503读取当前设置”	发送G代码，返回EEPROM值
“检查温度是否稳定”	在10秒内读取5个读数，检测不稳定
“上传并打印benchy.gcode”	将文件上传到服务器并开始打印
“暂停打印”	通过Repetier服务器暂停当前作业
“将床温设置为60”	将加热床设置为60℃
“我的打印机在哪个端口？”	扫描串行端口并自动检测打印机

快速开始

从GitHub安装

pip install git+https://github.com/Nstalej/repetier-mcp.git

或与 uv （推荐--更快，无依赖冲突）：

pip install uv
uv pip install git+https://github.com/Nstalej/repetier-mcp.git

对于 串行模式 （直接USB），也安装pyserial：

pip install "repetier-mcp[serial] @ git+https://github.com/Nstalej/repetier-mcp.git"

发展：

git clone https://github.com/Nstalej/repetier-mcp.git
cd repetier-mcp
pip install -e ".[dev]"
pytest

连接模式

repetier mcp支持两种连接模式：

模式1：废除服务器（推荐）

通过HTTP REST API连接到网络上运行的Repetier-Server。支持所有功能，包括文件上传、暂停/恢复和作业管理。

模式2：直接串行（USB）

通过USB/串行端口（pyserial）直接连接到打印机。 Repetier Host用户的经典模式。需要 serial 额外。

配置

废除服务器模式

变量	默认值	描述
`REPETIER_MODE`	`serial`	设置为 `server`
`REPETIER_SERVER_URL`	`http://localhost:3344`	Repetier服务器的完整URL
`REPETIER_SERVER_APIKEY`	（空）	Repetier-Server的API密钥
`REPETIER_PRINTER_SLUG`	（空）	服务器中的打印机段/名称
`PRINTER_MODEL`	`sidewinder_x1`	用于诊断的打印机型号

直接USB/串行模式

变量	默认值	描述
`REPETIER_MODE`	`serial`	连接方式： `serial` 或 `server`
`REPETIER_PORT`	（自动）	串行端口，例如。 `/dev/ttyUSB0` 或 `COM3`
`REPETIER_BAUD`	`115200`	波特率-- 使用 `250000` 适用于响尾蛇X1
`PRINTER_MODEL`	`sidewinder_x1`	用于目标诊断的打印机型号

自动检测： 如果 REPETIER_SERVER_URL 设置和 REPETIER_MODE 不是，服务器模式被自动选择。

Claude桌面设置

视窗

步骤1--找到打印机的COM端口（仅限串行模式）

通过USB连接打印机
打开 设备管理器 (Win + X >设备管理器）
扩展 端口（COM和LPT）
寻找 USB-SERIAL CH340 (COM3) 或类似
记下您的端口号

响尾蛇X1： 使用CH340芯片。如果没有显示任何内容，请从安装驱动程序 wch-ic.com/downloads/CH341SER_EXE.html

步骤2--配置Claude桌面

在以下位置打开（或创建）配置文件：

C:\Users\YOUR_USERNAME\AppData\Roaming\Claude\claude_desktop_config.json

服务器模式（推荐）：

{
  "mcpServers": {
    "repetier": {
      "command": "python",
      "args": ["-m", "repetier_mcp.server"],
      "env": {
        "REPETIER_MODE":          "server",
        "REPETIER_SERVER_URL":    "http://localhost:3344",
        "REPETIER_SERVER_APIKEY": "YOUR_API_KEY_HERE",
        "REPETIER_PRINTER_SLUG":  "SidewinderX1",
        "PRINTER_MODEL":          "sidewinder_x1"
      }
    }
  }
}

串行模式：

{
  "mcpServers": {
    "repetier": {
      "command": "python",
      "args": ["-m", "repetier_mcp.server"],
      "env": {
        "REPETIER_MODE":  "serial",
        "REPETIER_PORT":  "COM3",
        "REPETIER_BAUD":  "250000",
        "PRINTER_MODEL":  "sidewinder_x1"
      }
    }
  }
}

重新启动克劳德桌面。

Linux

pip install "git+https://github.com/Nstalej/repetier-mcp.git"
# For serial mode:
# pip install "repetier-mcp[serial] @ git+https://github.com/Nstalej/repetier-mcp.git"
# sudo usermod -a -G dialout $USER  # then log out and back in

编辑 ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "repetier": {
      "command": "python3",
      "args": ["-m", "repetier_mcp.server"],
      "env": {
        "REPETIER_MODE":          "server",
        "REPETIER_SERVER_URL":    "http://localhost:3344",
        "REPETIER_SERVER_APIKEY": "YOUR_API_KEY_HERE",
        "REPETIER_PRINTER_SLUG":  "SidewinderX1",
        "PRINTER_MODEL":          "sidewinder_x1"
      }
    }
  }
}

macOS

pip install "git+https://github.com/Nstalej/repetier-mcp.git"

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "repetier": {
      "command": "python3",
      "args": ["-m", "repetier_mcp.server"],
      "env": {
        "REPETIER_MODE":          "server",
        "REPETIER_SERVER_URL":    "http://localhost:3344",
        "REPETIER_SERVER_APIKEY": "YOUR_API_KEY_HERE",
        "REPETIER_PRINTER_SLUG":  "SidewinderX1",
        "PRINTER_MODEL":          "sidewinder_x1"
      }
    }
  }
}

故障排除（Windows）

问题	解决方案
打印机不在设备管理器中	请尝试使用其他USB电缆——许多电缆仅用于充电
CH340驱动程序缺失	从安装 wch-ic.com
端口繁忙/访问被拒绝	请先关闭Repetier主机——它和此MCP无法共享端口
打印过程中随机断开连接	在设备管理器>USB集线器中禁用USB电源管理
无法连接到服务器	验证Repetier服务器是否正在运行以及URL/端口是否正确
API密钥错误	检查REPETIER_SERVER_APIKEY是否与REPETIER-SERVER设置中的密钥匹配
找不到打印机段	检查REPETER_Printer_slug是否与REPETIER服务器中的打印机名称匹配

可用工具

工具	模式	描述
`printer_status`	两者都	获取温度、工作进度和位置
`send_gcode`	两者	发送任何G码/M码命令
`temperature_check`	两者	多样本温度稳定性分析
`set_temperature`	两者都可以	设置床温或床温
`list_jobs`	服务器	列出打印队列
`upload_and_print`	服务器	上传.gcode文件并开始打印
`pause_print`	服务器	暂停当前打印作业
`resume_print`	服务器	恢复暂停的打印作业
`cancel_print`	服务器	取消/停止当前打印
`diagnose_error`	两者都有	人工智能支持的错误诊断和修复步骤
`knowledge_base_summary`	两者	显示所有已知的错误类型及其症状
`list_serial_ports`	两者	扫描串行端口或显示服务器连接信息
`emergency_stop`	两者都	发送M112紧急停止

Repetier-Server REST API参考

服务器模式使用Repetier-server REST API：

GET  /printer/api/{slug}?a=stateList&apikey={key}           # Full printer state
GET  /printer/api/{slug}?a=send&data={"cmd":"G28"}&apikey={key}  # Send G-code
GET  /printer/api/{slug}?a=listJobs&apikey={key}             # List jobs
GET  /printer/api/{slug}?a=pause&apikey={key}                # Pause print
GET  /printer/api/{slug}?a=continueJob&apikey={key}          # Resume print
GET  /printer/api/{slug}?a=stopJob&apikey={key}              # Cancel print
GET  /printer/api/{slug}?a=setExtruderTemperature&data={...} # Set hotend temp
GET  /printer/api/{slug}?a=setBedTemperature&data={...}      # Set bed temp
POST /printer/job/{slug}?a=upload&name=file.gcode&apikey={key}   # Upload gcode

诊断知识库

炮兵响尾蛇X1的内置错误数据库-- 11种错误类型:

错误类型	主要症状
`thermal_runaway`	热运行、加热故障、温度传感器
`layer_shifting`	层移、跳过步骤、位置丢失
`z_offset_drift`	第一层问题、河床平整问题
`extruder_clicking`	点击、研磨、挤压
`communication_error`	打印机脱机、无响应、超时
`bed_adhesion`	翘曲、不粘、翘角
`bltouch_probe_error`	BLTouch报警，探头展开/收起失败
`tmc_driver_noise`	电机噪音、TMC2208呜呜声、步进器振动
`hotend_ptfe_degradation`	燃烧气味、PTFE烟雾、热蠕变、反复堵塞
`tft_display_error`	屏幕冻结，白屏，TFT无响应
`psu_failure`	随机关机，打印机死机，24V掉轨

加 4个通用错误 （最低温度、最高温度、丝状输出、sd_card_error）。

每个诊断包括 可能原因, 编号的维修步骤，以及 精确的G代码命令 在故障排除期间运行。

路线图

[]OctoPrint兼容层
[]Klipper/Moonraker支架
[]网络摄像头快照集成
[]打印时间预测分析
[]灯丝使用情况跟踪
[]响尾蛇X1 EEPROM调谐向导

贡献

欢迎发布问题和PR。特别是：

诊断知识库的其他打印机型号
Klipper/Moonraker适配器

git clone https://github.com/Nstalej/repetier-mcp
cd repetier-mcp
pip install -e ".[dev]"
pytest

许可证

麻省理工学院——见许可证