asset-register

mcp-asset-register

位于 官方 MCP Registry（io.github.theluckystrike/asset-register）。 维护固定资产登记簿，并按照税务机关实际公布的折旧率计提折旧。你只需提供购置资产、成本、投入使用时间和所属类别；它就会提供折旧率、使用年限、计提约定、按年或按月编制的完整折旧表、月度会计分录，以及出售资产时的收益或损失。它附带三张表：根据 KST 分类编制、取自 CIT 和 PIT 法案附件的波兰年度折旧率；英国资本折让池及年度投资津贴；以及适用于 3 年、5 年和 7 年财产的美国 MACRS GDS 半年期表。这些表以文件形式随附，并非实时数据源，因此同一资产重复计算折旧会得到相同结果；每个折旧率都附有法律文书、来源 URL 和生效日期。数据不会离开你的设备。

由 theluckystrike 构建。

安装

一键安装（.mcpb）：从最新版本下载 asset-register.mcpb，然后在 Claude Desktop 中双击： https://github.com/theluckystrike/mcp-servers/releases/latest

托管版，无需安装：将基于 URL 的客户端指向 https://mcp.zovo.one/mcp/asset-register。GET https://mcp.zovo.one/mcp/connect 会生成令牌并输出可直接使用的 URL。

@theluckystrike/mcp-asset-register 的 npm 发布尚未完成，因此下面的 npx 命令目前会返回 404。

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

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

Claude Code：

claude mcp add asset-register -- npx -y @theluckystrike/mcp-asset-register

Cursor（~/.cursor/mcp.json 或 .cursor/mcp.json）：使用与 Claude Desktop 相同的条目。

工具

工具	功能
asset_add	向登记簿添加一项资产。折旧率、使用年限和计提约定取自随附表格；两者都可以覆盖。
asset_list	显示指定日期的登记簿，包含成本、累计折旧和账面净值，并按币种汇总。
asset_schedule	为已登记资产或仅用于估价的资产编制完整折旧表，可按年或按月计算，直至折旧到零或残值。
asset_journal	编制一个月的会计分录：借记折旧费用，贷记累计折旧，列出各项资产和总额，并附上 expense_add 载荷。
asset_dispose	记录资产出售、报废或核销，并计算截至该日期相对于账面净值的收益或损失。
asset_delete	移除没有依赖项的资产，并返还其免费版名额。已处置或已记账的资产无法移除，并会指出依赖项名称。
asset_report	按类别和币种列出账面净值、当年折旧额，以及当年的每项资产处置及其结果。
license_status	查看 Free 或 Pro 许可状态及升级方式。
license_activate	激活 Pro 密钥。离线验证。

阅读 assets://categories 资源，查看所有随附类别、代码、折旧率及各表未涵盖的内容。

Free 与 Pro

	Free	Pro
登记簿中的资产数	10	无限
asset_schedule	是，无限使用	是
asset_list、asset_dispose、asset_delete	是，无限使用	是
asset_journal	否	是
asset_report	否	是

获取 Pro：一次性支付 $19，或购买捆绑包，价格为 $39。

表格包含什么，以及有意不包含什么

src/tables/ 下的每张表都带有一个 header，其中包含主管机构、税务工具、来源 URL、税率生效日期和读取日期。assets://categories 资源会连同税率一起返回这些表头，因此来源信息会随数值一同提供。

表格内容遵循以下规则：对于无法根据公开文本有把握地确定的数值，一律省略，而不猜测。 折旧率最终会出现在纳税申报表上。一个看似权威却错误的数值，比缺失的数值更糟糕，因为缺失的数值会被明确拒绝，你便会去查证。

表格	已收录	未收录
波兰，KST	共 33 行，涵盖此版本能够有把握确定的附录项目：0%（土地，不计提折旧）、1.5%、2.5%、4.5%、7%、10%、14%、20% 和 30%；列出 KST 组和子组级别的税率，以及各项是否符合余额递减法的适用条件	附录中的 18% 和 25% 项目。无法有把握地确定其 KST 归属，因此没有任何行声称涵盖这些项目。此外还未收录每个六位数的 KST 代码：由纳税人对资产进行分类，本表仅列出税率
英国，资本抵免	18% 的普通税率池、6% 的特殊税率池，以及以 100% 首年扣除行列出的年度投资抵免，附有 1,000,000 英镑的上限	首年及全额费用化规则、建筑物和构筑物抵免、小额资产池抵免、决定车辆所属税率池的 CO2 门槛，以及所有平衡性收费。这些内容都会随日期变化，此处均无法有把握地确定
美国，MACRS	按 半年惯例计算的 3 年、5 年和 7 年 GDS 类别，采用已发布的 Pub 946 表 A-1 百分比	季中和月中惯例、27.5 年和 39 年不动产类别、10 年、15 年和 20 年类别、替代折旧制度、section 179 和奖金折旧。10 年类别会被明确拒绝，而不会用 7 年类别近似替代

税率会发生变化。依赖任何回答前，请检查其中的 effective_date；如果购买时间较近，请阅读 source_url。

引擎采用的规则

• 波兰从资产登记后的次月开始计提折旧（art. 16h ust. 1 pkt 1）。资产于 3 月 15 日投入使用，则从 4 月 1 日开始计提，因此第一年按年折旧率的九成十二计提，折旧计划的日历年限也会比预计使用年限多一年。每个回答都会列明首个计提月份。
• 波兰的余额递减法会切换（art. 16k）。折旧率乘以最高为 2.0 的系数，应用于账面净值；在递减金额低于直线法金额的第一年，后续计划改用直线法。乘用车（KST 741）和建筑物完全不适用此方法，因此系统会拒绝，而不会悄悄计算。
• 英国的减值准备是适用于资产池的比率，而非单项资产的折旧额。 本服务将其应用于单项资产，以便得出单项资产的金额，并会在每个回答中说明这一点。纯粹的余额递减法永远不会降至零，因此折旧计划最多计算 25 期，最后一期会冲销剩余金额，依据说明中会注明这一处理。
• MACRS 不考虑残值。 公布的百分比会收回全部成本。对于美国资产，若提供了残值，系统会反馈该残值已忽略，并将其保留在记录中供账面用途，而不会悄悄减少折旧基数。
• 各期金额之和精确等于可折旧基数，精确到最小货币单位。 金额从头到尾都以整数最小货币单位处理，折旧计划通过累计舍入分配，因此对任何输入都有 sum(periods) == cost - residual，且月度明细之和等于年度金额。
• 完全相同的资产会被拒绝，不会重复存储。 asset_add 会规范化名称、类别、成本、货币、日期、方法、年限、方案和残值；若记录与登记册中已有资产相符，系统会返回该资产的 ID 并拒绝写入。重试调用和重新运行脚本看起来都与第二台机器无异；在最多容纳 10 项资产的免费方案中，第二行会占用一个无法收回的名额。两件确实相同的资产可以合法登记：为第二件资产提供一个可区分的名称即可通过。
• asset_delete 可用于撤销操作，而且免费。 它会移除没有任何依赖项的资产。已记录的处置或已由 asset_journal 入账的月份都属于依赖项；此时删除会被拒绝，并指出相应依赖项，而不会移除某个已经离开本服务、并形成金额记录的成本。ID 永不重新分配。
• 折旧计提至处置月份（含该月），然后停止。 处置收益或损失等于处置所得减去该月份的账面净值，处置分录借贷平衡，净额为零。
• 不同货币绝不相加。 本服务没有汇率，因此 PLN 登记册和 USD 登记册会分别保留为两笔金额。

过账到费用跟踪器

asset_journal 会返回传给 expense-tracker 服务的准确 expense_add 参数，每种货币对应一个载荷；它本身不会写入费用。这是有意为之：expense-tracker 没有公开库入口，其 ID 计数器、类别规则、VAT 拆分和货币默认值都位于其自身锁保护下的 expense_add 处理程序中。直接向其 data.json 追加一行，会生成一条未应用上述规则的记录：看起来像原生记录，实际却不是。返回这些参数与 per-diem 和 kanban 使用的是同一契约。此操作会标记登记册：凡是生成过分录的资产都会记录月份，因此，如果某项资产的折旧已过账，asset_delete 可以拒绝删除，而不会移除已过账金额背后的成本。

载荷不会设置 vat_rate。折旧是账面费用，不是采购，因此不涉及进项 VAT。

一项经过验证的发现

年度计划表是查找舍入误差的地方，而这些误差实际上出现在月度日志中。

对于这 3 张表能为某项测试资产（成本为 12,345.67，残值为 45.67，2026 年 3 月 12 日投入使用）生成的 67 种计划，几乎无论采用哪种舍入规则，年度行看起来都很准确，因为年度金额是基数的百分比，结果会落在整分或接近整分的位置。将这些年份按月拆分，并对每个月独立舍入后，67 种方案中有 35 种的合计不再等于可折旧基数，误差最多达 390 个最小货币单位，即一项价值 12,345.67 的资产相差 3.90。问题最严重的是使用年限最长的方案：住宅建筑按 1.5% 折旧时，基数会分摊到 800 个月，而 800 次半分舍入正是 3.90 误差的来源。

这与直觉恰恰相反。月度拆分看起来只是无害的呈现步骤，是实际算术完成后的处理，因此这个步骤只用了裸露的 Math.round，没有任何测试。但它也是唯一会被记账的步骤：没人会按年记账，只会按月记账，因此实际进入账簿的数字来自未经过检查的步骤。修复方法是让 allocate 在每一步对累计总额进行舍入，并将每期金额设为相邻两个舍入后累计值之差；最后一期则设为剩余金额。这一方法同时应用于月度拆分和年度拆分。随后，test/contract.test.mjs 会验证这些表能生成的每一种计划都满足等式，而不只是单元测试可能挑出的两三种。

隐私

所有内容都保留在你的设备上。资产以 JSON 格式存储在 ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/asset-register/ 下。费率表是软件包中的文件。此服务不会发起任何网络请求，无需账户或 API 密钥。许可证密钥会离线验证。

许可证

MIT。支持邮箱：[email protected]

将这些文档用作 MCP 服务

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

• 文档 MCP URL：https://gitmcp.io/theluckystrike/mcp-asset-register