3D Print Log

Name: 3D Print Log
Author: 3dprintlog.com

远程服务

3dprintlog.com游戏娱乐101 天前更新

代码仓库访问官网

关于 3D Print Log

3D Print Log 的 MCP 服务让用户和 AI Agent 管理、查询 3D 打印记录，涵盖打印任务、打印机、耗材和项目，并支持切片器导入与打印机自动记录。

主要功能

01记录打印时长、材料、质量和图片
02管理打印机及各机统计
03跟踪耗材库存、用量和成本
04按项目归类打印并管理图片集
05从指定切片器导入设置
06通过 OctoPrint 和 Klipper/Moonraker 自动记录

适用场景

01记录并查看已完成的打印任务
02监控耗材库存与成本
03按项目整理相关打印
04从受支持的打印机设置自动记录打印

MCP 相关

API 在 `https://api.3dprintlog.com/mcp` 提供 MCP 服务，供 AI Agent 使用。仓库还包含用于调用该服务的 Agent skill。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://api.3dprintlog.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http com-3dprintlog-printlog https://api.3dprintlog.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"com-3dprintlog-printlog":{"type":"http","url":"https://api.3dprintlog.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"com-3dprintlog-printlog":{"type":"http","url":"https://api.3dprintlog.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"com-3dprintlog-printlog":{"type":"http","url":"https://api.3dprintlog.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"com-3dprintlog-printlog":{"serverUrl":"https://api.3dprintlog.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

3D Print Log API

为 3D Print Log 提供支持的后端 API——这是一个用于跟踪 3D 打印、打印机和耗材的 Web 应用。已在生产环境运行：api.3dprintlog.com/swagger。

功能

打印记录 — 记录打印任务的时长、材料用量、质量评分和图片
打印机 — 管理打印机库存，并查看每台打印机的统计数据
耗材 — 跟踪耗材库存、用量和成本
项目 — 将相关打印记录归入同一项目，并提供项目级图片集
切片软件集成 — 直接从 Cura、OrcaSlicer、PrusaSlicer 和 Bambu Studio 导入打印设置
打印机 Webhook — 通过 OctoPrint 和 Klipper/Moonraker 集成自动记录打印
电费跟踪 — 记录每台打印机的功率，并计算每次打印的电费
双重身份验证 — Web 应用使用 Auth0 JWT Bearer，集成使用 API 密钥（X-Api-Key header）
图片上传 — 通过 Azure Blob Storage 存储每次打印和每个项目的图片

API 文档

探索在线 API：api.3dprintlog.com/swagger

开始使用

本地设置、配置和运行测试请参阅 CONTRIBUTING.md。

前端位于 HoffmanEngineering/3d-print-log-ui。大多数功能开发都需要同时在本地运行两者。

技术栈

ASP.NET Core (.NET 10)
Entity Framework Core + SQL Server
Auth0（JWT Bearer 身份验证）
Azure Blob Storage（文件存储）
Stripe（订阅计费）

基础设施

生产环境运行在 Azure 上（App Service、SQL Server、Blob Storage）。这部分由人工管理。电子邮件是个例外：Amazon SES、其 DNS 和事件 Webhook 主题通过 HoffmanEngineering/3d-print-log-infra 中的 Terraform 定义。

电子邮件通过 Email 部分配置（PrintLogApi/Email/EmailOptions.cs 列出了所有键和默认值；示例 appsettings 文件展示了配置结构）。默认情况下处于关闭状态：只有将 Email:Enabled 设为 true 才会发送邮件。docs/email-runbook.md 介绍了试运行、正式启用、密钥轮换和单实例要求；docs/email-metrics.md 介绍了留置组测量数据。

如果你的贡献需要更改基础设施（新增环境变量、Azure 资源配置等），请在 PR 描述中明确说明，以便维护者在代码发布前协调这些更改。

问题与讨论

使用相关问题最好在 3D Print Log 讨论区 提出。该讨论区是整个项目的入口，涵盖 Web 应用、本仓库以及两个切片软件插件——你不必判断问题属于哪个仓库，答案也会保留为可搜索内容，方便之后遇到相同问题的人查找。

错误报告和功能请求仍应提交到本仓库的 issues。

与 AI Agent 搭配使用

该 API 在 https://api.3dprintlog.com/mcp 上托管了一个 MCP 服务，本仓库还发布了一项 Agent 技能，指导 Agent 如何有效使用它： skills/3d-print-log。

# The skill, for any agent the skills CLI supports
npx skills add HoffmanEngineering/3d-print-log-api

# The skill and the MCP server together, as a Claude Code plugin
claude plugin marketplace add HoffmanEngineering/3d-print-log-api
claude plugin install 3d-print-log@3d-print-log

仓库根目录也是一个 Agent Plugins 软件包（plugin.json 和 mcp.json）。