Repetier MCP

重复性mcp

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

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

英文自述| 西班牙语

______________________________________________________________________

你能做什么

______________________________________________________________________

快速开始

从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 额外。

______________________________________________________________________

配置

废除服务器模式

直接USB/串行模式

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

______________________________________________________________________

Claude桌面设置

视窗

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

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

响尾蛇X1： 使用CH340芯片。如果没有显示任何内容，请从安装驱动程序

步骤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）

______________________________________________________________________

可用工具

______________________________________________________________________

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种错误类型:

加 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

______________________________________________________________________

许可证

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