关于 depreciation
depreciation 是固定资产登记与折旧的 MCP 服务,依据内置的波兰、英国和美国税率表生成折旧计划。它还提供月度日记账分录和处置损益,数据保存在本机。
主要功能
- 01维护固定资产登记册
- 02生成年度或月度折旧计划
- 03计算月度日记账分录
- 04记录处置并计算损益
- 05使用内置波兰、英国和美国税率表
适用场景
- 01登记新购置的固定资产
- 02查看资产折旧计划
- 03准备月度折旧日记账
- 04计算资产处置结果
MCP 相关
向 MCP 客户端提供资产管理和折旧工具,以及包含内置类别和税率信息的 `assets://categories` 资源。`asset_journal` 返回供费用追踪服务使用的 `expense_add` 参数,但不会自行记入费用。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
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 直接读取此代码库的文档,无需安装:
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。