Maintenance Schedule

io.github.theluckystrike由 GitHub 账号 theluckystrike 发布v0.22.5更新于 Oct 24, 2026

An equipment maintenance schedule and log: service entries, costs, and what is due or overdue.

已验证STDIO仅桌面效率与工作流商业与电商

概览

AI 生成的概览

本地设备保养登记簿,让助手添加设备、记录保养与费用,并报告哪些到期或逾期。

可以做什么
  • 添加和删除设备,记录名称、序列号或资产标签、位置、备注与币种
  • 记录保养或维修:日期、内容、以分为单位的费用、技师,以及下次到期日或间隔天数
  • 生成到期报告:哪些已逾期、未来 N 天内到期、尚未排期(Pro)
  • 查看单台设备的完整时间顺序记录、总支出与按技师划分的支出
  • 按日期范围导出 CSV,或按设备导出 Markdown 摘要
  • 查询或激活免费版或 Pro 授权
适用场景
适合为车间设备、出租房、车队或工作室器材维护一份本地登记簿,并让助手回答哪些保养即将到期或已经逾期。
运行要求
以本地进程方式在桌面运行,可通过 mcpb 包或克隆后自行构建安装;npm 包尚未发布,npx 目前会失败。无需账号、API 密钥或网络调用。可选的 Pro 授权密钥通过 MCP_LICENSE_KEY 环境变量提供,并离线校验。
安装前请注意
Pro 功能(不限设备数量、到期报告、Markdown 摘要)需要付费的一次性授权密钥,免费版最多三台设备。删除带记录的设备需显式确认且不可恢复,资产编号不会重新分配。数据保存在本机的 JSON 文件中。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Maintenance Schedule,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

mcp-maintenance-log

[theluckystrike/mcp-maintenance-log MCP server]

In the official MCP Registry (io.github.theluckystrike/maintenance-log). An mcp maintenance log for the workshop, the rental flats, the van fleet or the studio: one local register of every piece of equipment you look after, and the work that has been done on it. Add each asset once, name, serial or asset tag, where it lives, then log each service or repair as it happens: the date, what was done, what it cost in cents, who did it, and when the next service falls due, either as a date or as an interval in days. Ask what is due and the report answers what is overdue and what comes up in the next N days, computed from the stored dates at the moment you ask, so it can never go stale. Per-asset history keeps the chronological log with its total spend, and export hands the record over as CSV for a spreadsheet or a Markdown summary per asset. Everything stays on this machine; there is no account and no network call.

Built by theluckystrike.

npm publish for @theluckystrike/mcp-maintenance-log is pending, so npx -y @theluckystrike/mcp-maintenance-log returns 404 today. Until then, a clone+build is the working path.

Install

Claude Desktop

macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json:

json
{  "mcpServers": {    "maintenance-log": {      "command": "npx",      "args": ["-y", "@theluckystrike/mcp-maintenance-log"]    }  }}

Claude Code

sh
claude mcp add maintenance-log -- npx -y @theluckystrike/mcp-maintenance-log

Cursor

~/.cursor/mcp.json (global) or .cursor/mcp.json (project), same entry as Claude Desktop.

Tools

toolwhat it does
asset_addAdd an asset: name, serial or asset tag, location, notes, currency. Returns AST-YYYY-NNNN. A duplicate tag is refused
maintenance_logLog work on an asset: the day, what was done, cost in cents, technician, and the next due date -- as next_due or as interval_days, never both
maintenance_dueThe due report: what is overdue and by how many days, what falls due within N days (default 30), what is scheduled later, what has no schedule. Pro
asset_historyOne asset in full: every entry in chronological order, total spend in integer cents, spend per technician, the schedule it currently lives under
maintenance_exportEntries in a date range as CSV (free) or a Markdown summary per asset (Pro)
asset_removeRemove an asset. One carrying a log is refused unless confirm: true, naming what would be lost. The AST number is never reissued
license_status / license_activateFree or Pro, and the key

Free vs Pro

FreePro
Assets on the register3Unlimited
Logging work, cost and technicianYesYes
Per-asset history and total spendYesYes
CSV export of a date rangeYesYes
Due report: overdue and due-within-N-days--Yes
Markdown summary per asset--Yes

The record is never metered. Three assets with full logging and CSV export is a real working register for a one-machine shop, and nothing you have logged is ever held back. What Pro lifts is how many assets are on the register, and adds the due report and the Markdown summaries.

Get Pro: https://mcp.zovo.one/buy/maintenance-log, $19 one-time for this server, or $39 for the bundle.

Dates and money

Every date is stored as ISO 8601 (YYYY-MM-DD). Whether a service is overdue is computed from today's date at call time, never stored, so the register cannot go stale. An interval is turned into a date once, when the work is logged: the work date plus the interval, in whole days, in UTC so the answer does not depend on the server's timezone. Every cost is an integer number of cents in the asset's own currency (1200 is 12.00), stored on the entry; a total spend is the sum of the stored entries, so it can never drift from the lines it is made of.

Privacy

All data stays local, in ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/maintenance-log/. Two files: assets.json, counter.json. Nothing is sent anywhere, there is no account, no API key and no network call in this server at all. License keys are verified offline.

Built by theluckystrike. https://github.com/theluckystrike

Use these docs as an MCP server

Any MCP client (Claude, Cursor, Windsurf, VS Code) can read this repository's documentation directly via GitMCP - no install:

来源:servers/maintenance-log/README.md,提交 55b3f42

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

2
  1. v0.22.5最新Oct 14, 2026
  2. v0.22.0Sep 23, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分