{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3gegtgwnadj7","handle":"timeverse-3dprinter-mcp","url":"https://wellknown.network/agents/timeverse-3dprinter-mcp","links":{"self":"https://wellknown.network/agents/timeverse-3dprinter-mcp/record.json","html":"https://wellknown.network/agents/timeverse-3dprinter-mcp","markdown":"https://wellknown.network/agents/timeverse-3dprinter-mcp/record.md","api":"https://wellknown.network/api/v1/agents/timeverse-3dprinter-mcp","status":"https://wellknown.network/api/v1/agents/timeverse-3dprinter-mcp/status","claim":"https://wellknown.network/agents/timeverse-3dprinter-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/timeverse-3dprinter-mcp/claim.json","badge":"https://wellknown.network/agents/timeverse-3dprinter-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/timeverse-3dprinter-mcp/history","tools":"https://wellknown.network/api/v1/agents/timeverse-3dprinter-mcp/tools"},"ard":{"identifier":"urn:air::server:timeverse-3dprinter-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"timeverse-3dprinter-mcp","summary":"TimeVerse 3D Printer Control MCP Server — 支持多种通讯方式的 3D 打印机控制","description":"# TimeVerse 3D Printer MCP Server\n\n![Python Version](https://img.shields.io/badge/python-3.12%2B-blue)\n![MCP](https://img.shields.io/badge/MCP-1.0%2B-green)\n\n**3D 打印机控制 MCP 服务器** — 支持 7 种通讯协议，提供实时状态监控、G-Code 处理、切片集成、网络发现等功能。通过 32 个 MCP 工具覆盖 3D 打印全生命周期管理。\n\n---\n\n## 目录\n\n- [功能特性](#功能特性)\n- [快速开始](#快速开始)\n- [安装方式](#安装方式)\n  - [方式一：通过 uvx 安装（推荐）](#方式一通过-uvx-安装推荐)\n  - [方式二：通过 pip 安装](#方式二通过-pip-安装)\n  - [方式三：直接 Python 运行](#方式三直接-python-运行)\n- [凭证配置指南](#凭证配置指南)\n  - [方法 A：配置文件（推荐）](#方法-a配置文件推荐)\n  - [方法 B：环境变量](#方法-b环境变量)\n  - [方法 C：工具调用时传入](#方法-c工具调用时传入)\n- [MCP 客户端配置](#mcp-客户端配置)\n  - [uvx 模式](#uvx-模式)\n  - [pip 模式](#pip-模式)\n  - [Python 直接运行模式](#python-直接运行模式)\n- [工具列表](#工具列表)\n  - [发现工具 (3 个)](#发现工具-3-个)\n  - [打印工具 (7 个)](#打印工具-7-个)\n  - [状态查询 (4 个)](#状态查询-4-个)\n  - [文件管理 (4 个)](#文件管理-4-个)\n  - [G-Code 指令 (7 个)](#g-code-指令-7-个)\n  - [切片工具 (3 个)](#切片工具-3-个)\n  - [管理工具 (4 个)](#管理工具-4-个)\n- [传输协议说明](#传输协议说明)\n- [项目结构](#项目结构)\n- [环境变量参考](#环境变量参考)\n\n---\n\n## 功能特性\n\n- **7 种传输协议**：USB 串口、OctoPrint REST API、Moonraker (Klipper)、Duet Web Control、Repetier Server、Bambu Lab MQTT、Raw TCP\n- **32 个 MCP 工具**：覆盖发现、状态、打印、文件管理、G-Code 控制、切片、打印机管理\n- **智能路由**：根据打印机类型自动选择最佳传输协议\n- **G-Code 安全校验**：内置校验器检查温度、速度、流量等安全限制\n- **多切片器集成**：支持 PrusaSlicer、CuraEngine、OrcaSlicer，内置 6 个预设配置\n- **网络发现**：mDNS/Bonjour + 子网端口扫描自动发现局域网打印机\n- **灵活的凭证系统**：配置文件、环境变量、显式参数三种配置方式\n\n---\n\n## 快速开始\n\n```bash\n# 1. 安装\npip install -e .\n\n# 2. 配置凭证（见凭证配置章节）\n# 创建 timeverse-3dprinter.config.json 或设置环境变量\n\n# 3. 启动 MCP 服务器\ntimeverse-3dprinter-mcp\n```\n\n---\n\n## 安装方式\n\n### 方式一：通过 uvx 安装（推荐）\n\n[uvx](https://docs.astral.sh/uv/) 是 Astral 提供的快速 Python 包运行工具：\n\n```bash\n# 直接运行（无需安装）\nuvx timeverse-3dprinter-mcp\n\n# 或全局安装后运行\nuv tool install timeverse-3dprinter-mcp\nuvx timeverse-3dprinter-mcp\n```\n\n从本地源码运行：\n\n```bash\nuvx --from . timeverse-3dprinter-mcp\n```\n\n### 方式二：通过 pip 安装\n\n```bash\n# 从 PyPI 安装\npip install timeverse-3dprinter-mcp\n\n# 从本地源码安装\npip install -e .\n\n# 启动服务器\ntimeverse-3dprinter-mcp\n```\n\n### 方式三：直接 Python 运行\n\n```bash\n# 克隆/下载源码后\ncd timeverse-3dprinter-mcp\n\n# 直接运行（无需安装）\np…","publisher":{"name":"TimeVerse Studio","url":null},"homepage":"https://github.com/elimyliu/timeverse-3dprinter-mcp","repository":"https://github.com/elimyliu/timeverse-3dprinter-mcp","version":"1.0.0","license":"MIT","protocols":["mcp"],"tags":["3d-printer","mcp","octoprint","klipper","bambu-lab","gcode","3d-printing"],"pricing":null,"endpoints":[{"url":"pypi:timeverse-3dprinter-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"media.3d","name":"3D & Design","confidence":0.906,"provenance":"derived"}],"categories":["media"],"language":"fr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"timeverse-3dprinter-mcp","registry":"pypi","observedAt":"2026-11-04T02:26:28.987Z","publishedAt":"2026-07-24T09:34:40.795048Z","latestVersion":"1.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"timeverse-3dprinter-mcp","url":"https://pypi.org/project/timeverse-3dprinter-mcp/","firstSeenAt":"2026-09-10T14:22:36.811Z","fetchedAt":"2026-11-04T02:25:32.193Z","normalizedAt":"2026-11-04T02:25:32.193Z"}]},"firstSeenAt":"2026-09-10T14:22:36.811Z","updatedAt":"2026-11-04T02:26:28.987Z"}