maintenance-log

mcp-maintenance-log

已加入 官方 MCP Registry（io.github.theluckystrike/maintenance-log）。 适用于车间、出租公寓、货车队或工作室的维护日志 MCP：用一份本地登记簿记录你负责维护的每件设备，以及对它进行的维护工作。每项资产只需添加一次，填写名称、序列号或资产标签、存放地点，然后在每次维护或维修时记录日期、工作内容、以美分计的费用、执行人员，以及下次维护到期时间（可以是日期，也可以是以天为单位的间隔）。询问哪些项目到期时，报告会列出哪些已逾期，以及未来 N 天内哪些项目到期；结果根据你提问时存储的日期计算，因此永远不会过时。每项资产的历史记录按时间顺序保存日志，并汇总总支出；导出功能可将记录导出为 CSV，供电子表格使用，也可导出按资产整理的 Markdown 摘要。所有数据都保存在这台机器上；无需账号，也不会发起网络请求。

由 theluckystrike 开发。

@theluckystrike/mcp-maintenance-log 尚未发布到 npm，因此今天运行 npx -y @theluckystrike/mcp-maintenance-log 会返回 404。在此之前，可用的方式是克隆并构建。

安装

Claude Desktop

macOS：~/Library/Application Support/Claude/claude_desktop_config.json；Windows：%APPDATA%\Claude\claude_desktop_config.json：

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

Claude Code

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

Cursor

~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目），使用与 Claude Desktop 相同的配置项。

工具

工具	功能
asset_add	添加资产：名称、序列号或资产标签、地点、备注、货币。返回 AST-YYYY-NNNN。若标签重复则拒绝添加
maintenance_log	记录资产维护工作：日期、工作内容、以美分计的费用、技术人员，以及下次到期日期——填写 next_due 或 interval_days，不可同时填写
maintenance_due	到期报告：列出逾期项目及逾期天数、N 天内到期的项目（默认 30 天）、之后计划进行的项目，以及未安排维护的项目。Pro
asset_history	查看单项资产的完整记录：按时间顺序排列的所有条目、以整数美分计的总支出、各技术人员的支出，以及当前适用的维护计划
maintenance_export	将日期范围内的条目导出为 CSV（免费），或导出按资产整理的 Markdown 摘要（Pro）
asset_remove	移除资产。若资产已有日志，除非设置 confirm: true 并说明将丢失的内容，否则会拒绝移除。AST 编号不会重新发放
license_status / license_activate	查看 Free 或 Pro 状态，以及许可证密钥

Free 与 Pro

	Free	Pro
登记簿中的资产数	3	无限
记录工作、费用和技术人员	是	是
单项资产历史记录和总支出	是	是
导出日期范围内的 CSV	是	是
到期报告：逾期和未来 N 天内到期的项目	--	是
按资产整理的 Markdown 摘要	--	是

记录永远不会设有用量限制。对于只有一台机器的车间，记录 3 项资产并使用完整日志和 CSV 导出，就足以构成一份真正可用的登记簿；你记录的任何内容都不会被限制访问。Pro 提升了登记簿可容纳的资产数量，并新增到期报告和 Markdown 摘要。

获取 Pro：https://mcp.zovo.one/buy/maintenance-log，单个服务一次性付费 $19，或以 $39 购买套装。

日期和费用

每个日期都以 ISO 8601（YYYY-MM-DD）格式存储。服务是否逾期会在调用时根据当天日期计算，绝不存储，因此记录不会过期。记录工作时，会将间隔换算为日期：以工作日期加上间隔天数（取整天数），并使用 UTC，以确保结果不受服务器时区影响。每笔费用都是资产自身货币的整数分（1200 即 12.00），并存储在条目中；总支出是已存储条目的总和，因此永远不会与组成它的各条明细产生偏差。

隐私

所有数据都保存在本地，路径为 ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/maintenance-log/。包含两个文件：assets.json、counter.json。数据绝不会发送到任何地方；此服务完全不涉及账户、API 密钥或网络调用。许可证密钥会离线验证。

由 theluckystrike 构建。https://github.com/theluckystrike

将这些文档用作 MCP 服务

任何 MCP 客户端（Claude、Cursor、Windsurf、VS Code）都可以通过 GitMCP 直接读取此仓库的文档，无需安装：

• 文档 MCP URL：https://gitmcp.io/theluckystrike/mcp-maintenance-log