Spoolman MCP

🧵 Spoolman MCP服务器

______________________________________________________________________

🚀 这是什么？

这个MCP服务器弥合了人工智能助手（如克劳德）和你的自托管之间的差距 斯波尔曼 例子您无需点击Spoolman UI，只需 问 您的AI助手：

_“我还剩多少解放军？”_ _“添加一个新的Bambu Lab PETG线轴，1kg，红色。”_ _“标记50g使用的12号线轴。”_

服务器公开 完整Spoolman REST API v1 作为MCP工具，涵盖了每个供应商、灯丝、线轴、设置、自定义字段、查找和导出端点。

______________________________________________________________________

✨ 特性

• 🏭 供应商管理 --创建、读取、更新、删除供应商
• 🎨 长丝管理 --带有颜色、温度设置、物品编号的完整CRUD
• 🧵 假脱机管理 --跟踪线轴、日志使用（按重量或长度）、重量测量、归档
• ⚙️ 设置 --读写Spoolman配置
• 🏷️ 自定义字段 --管理供应商、长丝和线轴的额外字段
• 🔍 查找 --浏览所有材料、位置、批号、货号
• 📦 出口 --将数据导出为JSON或CSV
• 💓 系统 --健康检查、信息和备份触发器

\[！注意\] 此服务器与您的 本地/自托管 斯波尔曼实例。在使用此MCP服务器之前，您需要一个正在运行的Spoolman。

______________________________________________________________________

📋 需求

______________________________________________________________________

⚡ 快速开始

1.克隆和安装

git clone https://github.com/Disane87/spoolman-mcp.git
cd spoolman-mcp
npm install
npm run build

2.配置克劳德桌面

将以下内容添加到您的 claude_desktop_config.json:

macOS/Linux： ~/.config/claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "spoolman": {
      "command": "node",
      "args": ["/absolute/path/to/spoolman-mcp/dist/index.js"],
      "env": {
        "SPOOLMAN_URL": "http://localhost:7912"
      }
    }
  }
}

\[！重要\] 替换 /absolute/path/to/spoolman-mcp 使用克隆存储库的实际路径，以及 http://localhost:7912 使用Spoolman实例的URL。

3.重新启动克劳德桌面并开始聊天！ 🎉

______________________________________________________________________

🔧 配置

服务器通过以下方式配置 环境变量:

______________________________________________________________________

🛠️ 可用的MCP工具

🏭 供应商

🎨 灯丝

🧵 线轴

⚙️ 设置

🏷️ 自定义字段

🔍 查找

📦 出口

💓 系统

______________________________________________________________________

💬 对话示例

连接后，您可以进行自然对话，例如：

You: How many spools do I currently have?

Claude: You have 14 spools in Spoolman. 3 of them are archived.
        The active spools include 5x PLA, 4x PETG, and 2x ABS.

You: Add a new Bambu Lab PLA Basic spool. It's red, 1kg, 1.75mm.

Claude: I'll create that for you right away!
        ✅ Spool created: Bambu Lab PLA Basic (Red) — 1000g remaining.

You: I just printed something and used about 45g from spool #7.

Claude: Done! Spool #7 now has 623g remaining (was 668g).

You: I just weighed spool #3 on my kitchen scale — it's 312g total.

Claude: Got it! Based on the empty spool weight of 190g, spool #3
        now shows 122g of filament remaining.

______________________________________________________________________

🏗️ 项目结构

spoolman-mcp/
├── src/
│   ├── index.ts          # MCP server entry point & transport
│   ├── client.ts         # Typed Spoolman REST API client
│   └── tools/
│       ├── system.ts     # System tools (health, info, backup)
│       ├── vendors.ts    # Vendor CRUD tools
│       ├── filaments.ts  # Filament CRUD tools
│       ├── spools.ts     # Spool management tools
│       ├── settings.ts   # Settings tools
│       ├── fields.ts     # Custom field tools
│       ├── lookup.ts     # Lookup / discovery tools
│       └── export.ts     # Data export tools
├── dist/                 # Compiled JavaScript (after npm run build)
├── package.json
├── tsconfig.json
└── README.md

______________________________________________________________________

🔨 发展

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch mode (auto-rebuild on changes)
npm run watch

# Run directly with ts-node (no build step)
SPOOLMAN_URL=http://localhost:7912 npm run dev

______________________________________________________________________

🤝 贡献

欢迎投稿！如果您发现错误、有功能想法或想改进文档，请随时打开问题或拉取请求。

1. 分叉存储库
2. 创建要素分支(git checkout -b feat/my-feature)
3. 提交您的更改(git commit -m 'feat: add my feature')
4. 推到分支(git push origin feat/my-feature)
5. 打开拉取请求

______________________________________________________________________

📄 许可证

MIT许可证——见 许可证 了解详情。

______________________________________________________________________

🔗 相关斯波尔曼项目

看看斯波尔曼生态系统中的其他项目：

______________________________________________________________________

🙏 学分

• 模型上下文协议 Anthropic——支持AI工具集成的开放标准
• 灵感源自 线轴人家庭助理 💙

______________________________________________________________________

Made with ❤️ for the 3D printing community