🗿 OpenGalatea
一个开源的MCP服务器，让Claude完全控制您的Prusa 3D打印机——从在线查找模型到切片和打印，完全免提。当我们达到1K星时，我们将发布机器人手臂更新！未来的工作包括协调N台打印机进行生产优化。
OpenGalatea将Claude和您的Prusa打印机连接起来 模型上下文协议（MCP）。它专为希望自动化3D打印工作流程、运行打印农场或尝试人工智能驱动的制造管道的开发人员而设计。
以Galatea命名 --象牙雕像栩栩如生。OpenGalatea通过对话让您的打印机栩栩如生。
______________________________________________________________________
Arm grabbing a finished printed piece
我们正在努力集成SO-ARM-100，以完全自动化3D打印和3D打印对象的组装！
______________________________________________________________________
✨ 特性
- 🔍 搜索Printables.com 直接来自Claude的模型
- 📥 导入STL文件 来自URL、可打印文件或Google云端硬盘
- ⚙️ 自动切片 使用PrusaSlicer配置文件（打印机、材料、打印质量）
- 🤖 AI推荐的打印加载 根据您零件的要求
- 🖨️ 完全打印机控制 --启动、暂停、恢复、停止、监视
- 📁 管理文件 在打印机的USB存储器上
- 🐳 完全码头化 --一个开始的命令
- 📟 在Rasberry Pis的边缘奔跑 因此，您可以在打印机旁边部署一个小型本地服务器！
______________________________________________________________________
🗺️ 路线图
- \[ \] 机器人手臂集成 --作业完成后自动清除印版
- \[ \] 板材清洗臂 --喷洒异丙醇并清除灯丝残留物
- \[ \] 打印场编排器 --优化1台或N台打印机的作业调度
- \[ \] 迭代式零件改进 --模型→ 打印→ 检查→ 循环改进
______________________________________________________________________
🧰 技术栈
- python + FastMCP
- 普鲁萨切片机 （CLI）用于切片
- 码头工人 +Docker编写
- 吸烟 用于远程隧道接入
______________________________________________________________________
📋 先决条件
- Docker&Docker编写
- 运行固件的Prusa打印机 6.4.0或更高版本，已连接到您的本地网络
- ngrok（免费版运行良好）
- Python 3.11+（仅在没有Docker的情况下运行时需要）
- 打印机设置：
通过以下方式将打印机更新到固件≥6.4.0 设置→ 固件更新。然后将其连接到您的Wi-Fi网络。您的凭据(PRINTER_IP,PRINTER_USER,PRINTER_PASSWORD)可以在打印机上找到 设置→ 网络→ PrusaLink.
______________________________________________________________________
🚀 安装
1.克隆存储库
git clone https://github.com/GLechevalier/OpenGalatea.git
cd OpenGalatea2.配置环境变量
cp .env.example .env然后填写您的值：
PRINTER_IP=192.168.1.xx
PRINTER_USER=maker
PRINTER_PASSWORD=your_password
BASE_URL=http://192.168.1.xx
NGROK_BASE_URL=https://xxxx.ngrok-free.dev
PRUSA_SLICER_EXE=prusa-slicer
UPLOAD_DIR=/app/uploads看 配置 以获取每个变量的完整描述。
3.授予上传目录的写入权限
mkdir uploads
chmod 777 uploads/4.从Docker开始
docker compose up --buildMCP服务器将启动 http://localhost:8000.
4.用ngrok暴露服务器
在单独的终端中：
ngrok http 8000复制生成的HTTPS URL（例如。 https://xxxx.ngrok-free.dev)并将其设置为 NGROK_BASE_URL 在你的 .env 文件，然后重新启动容器。
______________________________________________________________________
⚙️ 配置
所有配置都是通过您的环境变量完成的 .env 文件。
| 变量 | 描述 | 示例 |
|---|---|---|
PRINTER_IP | Prusa打印机的本地IP地址 | 192.168.1.28 |
PRINTER_USER | 打印机的HTTP基本身份验证用户名 | maker |
PRINTER_PASSWORD | 打印机的HTTP基本身份验证密码 | your_password |
BASE_URL | 打印机的基本URL（用于本地API调用） | http://192.168.1.28 |
NGROK_BASE_URL | 您的公共ngrok HTTPS URL（用于公开MCP服务器） | https://xxxx.ngrok-free.dev |
PRUSA_SLICER_EXE | PrusaSlicer可执行文件名或完整路径 | prusa-slicer |
UPLOAD_DIR | 存储上传的STL和bgcode文件的目录 | /app/uploads |
打印机的IP、用户名和密码可在打印机上找到 设置→ 网络→ PrusaLink.
UPLOAD_DIR默认为/app/uploads在Docker容器内部，并且已经预先配置好了——只有在定制Docker设置时才能更改它。
______________________________________________________________________
🔌 连接到克劳德
一旦服务器运行并通过ngrok公开，在您的Claude客户端中添加OpenGalatea作为MCP服务器。
克劳德桌面(claude_desktop_config.json)
{
"mcpServers": {
"opengalatea": {
"url": "https://xxxx.ngrok-free.dev/mcp"
}
}
}Claude.ai（整合）
首选 设置→ 集成→ 添加集成 并粘贴您的ngrok网址：
https://xxxx.ngrok-free.dev/mcp______________________________________________________________________
🛠️ 可用工具
连接后，Claude可以访问以下工具：
🔍 发现模型
| 工具 | 说明 |
|---|---|
search_printables | 在Printables.com上搜索模特 |
get_print_files | 获取STL文件列表并下载模型的URL |
get_stl_download_url | 刷新已过期的签名下载URL |
📥 导入文件
| 工具 | 说明 |
|---|---|
upload_from_url | 下载STL或 .bgcode 从URL到服务器 |
list_uploads | 列出当前上传文件夹中的文件 |
delete_upload | 从上传文件夹中删除文件 |
⚙️ 切片
| 工具 | 说明 |
|---|---|
list_printer_profiles | 列出可用的打印机配置文件 |
list_print_and_material_profiles | 列出打印机的打印质量和材料配置文件 |
recommend_loadout | 为您的零件获取AI推荐的切片配置 |
slice_stl | 自动定位STL并将其切片为 .bgcode 文件 |
confirm_filament | 打印前确认装入了正确的灯丝 |
🖨️ 打印和控制
| 工具 | 说明 |
|---|---|
print_bgcode_file | 上传a .bgcode 转到打印机并启动作业 |
get_status_of_printer | 获取温度、打印机状态和作业进度 |
pause_print | 暂停当前打印作业 |
resume_print | 恢复暂停的打印作业 |
stop_print | 取消当前打印作业 |
list_files | 列出打印机USB存储器上的文件 |
delete_file | 从打印机的USB存储中删除文件 |
______________________________________________________________________
💬 用法
一旦克劳德连接到OpenGalatea，你就可以自然地与它交谈。以下是一些示例提示：
*“在Printables上给我找一个参数化的手机支架，打印出评价最高的一个。”*
*“用PETG将我刚刚以草稿模式上传的文件切片并开始打印。”*
*“我的打印机床的当前温度是多少？”*
*“暂停打印，我需要检查一下。”*
Claude将自动遵循正确的工作流程：搜索→ 导入→ 推荐设置→ 切片→ 确认灯丝→ 打印。
______________________________________________________________________
🔧 不使用Docker运行
pip install -r requirements.txt
python main.py确保您的系统中已安装并可访问PrusaSlicer PATH.
______________________________________________________________________
🤝 贡献
非常欢迎捐款！OpenGalatea是一个早期项目，有很多工作要做。
贡献：
- 分叉存储库
- 创建要素分支(
git checkout -b feat/my-feature) - 提交您的更改(
git commit -m 'feat: add my feature') - 推送并打开拉取请求
请先打开一个问题，了解主要变化，以便我们讨论方法。
______________________________________________________________________
🙏 学分
OpenGalatea建立在这些开源项目的基础上：
______________________________________________________________________
📄 许可证
该项目根据 MIT许可证.
MIT License
Copyright (c) 2026 GauthierLechevalier
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.______________________________________________________________________
Made with ❤️ and melted plastic