aus-accounting-mcp

Name: aus-accounting-mcp
Author: ryanduguid

本地服务

duguid.com.au金融数据3今天更新

代码仓库访问官网

关于 aus-accounting-mcp

aus-accounting-mcp 是面向澳大利亚会计师、簿记员及相关工具开发者的本地 MCP 服务，将独立发布的税务和工资计算引擎提供给 AI 助手。结果包含依据和未决事项，供人工审核，不构成建议或申报。

主要功能

01提供 14 项有明确范围的税务与养老金工作表
02检查 Payday Super 时限和 Division 7A 事项
03比较 ATO 行业基准并生成合成测试数据
04检索本地 Markdown 并返回带引用的片段
05在本地运行，不写入账簿或提交申报

适用场景

01核查养老金缴款的汇款和收款时限证据
02复核 Division 7A 贷款或税务工作表结果
03查找本地 Markdown 中的会计资料并核对引用

MCP 相关

它以本地 stdio MCP 服务运行，向 AI 客户端提供会计计算引擎和本地 Markdown 检索工具。工具在本地处理数据；连接的 MCP 主机仍会将参数和结果发送给其模型提供方。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "ryanduguid-aus-accounting": {
      "command": "uvx",
      "args": [
        "aus-accounting-mcp"
      ]
    }
  }
}

启动命令uvx aus-accounting-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiaus-accounting-mcp0.6.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
year	any	否	基准数据集年份，格式为 YYYY-YY，例如 "2023-24"。省略或设为 null 时，选择最新随附的数据集，而非实时查询 ATO。
limit	any	否	返回行业数上限，范围为 1 到 100；简洁地发现行业时使用 20。省略或设为 null 时，为保持兼容性，返回所有剩余匹配项。
offset	integer	否	筛选结果中的从 0 开始的位置；从 0 开始，然后在 has_more 为 true 时传入 next_offset。保持 search 和 year 不变。
search	any	否	可选的不区分大小写的行业名称搜索；省略则列出所选随附数据集中的所有行业。

详细介绍

七个独立发布的 Python 引擎，可根据您提供的数据应用澳大利亚税务和薪资规则；此外还有 Aus Accounting MCP，这是一个本地 Model Context Protocol 服务，可将这些引擎提供给 AI 助手。本项目服务于澳大利亚会计师、簿记员，以及为他们构建工具的开发者。每个工具都会返回计算结果、所用事实以及拒绝作出判断的事项。计算引擎和 MCP 服务均在本地运行：它们只读取你指定的文件，不会联系任何服务，不会写入账簿，也不会提交任何材料。另有两项边界：MCP 主机会将每个工具参数和结果发送给其模型提供商；下方的可选 LodgeiT 适配器仅在启用后才会进行范围受限的 HTTP 调用。缺失的事实仍然未知：如果某条 Payday Super 记录有基金收款日期，但没有 matched_amount 或 remitted_amount，它只能证明基金何时收到了一笔款项，不能证明金额，因此检查器会将其标记为 UNKNOWN，而不是 ON_TIME，并明确指出所需金额（从 payday-super-checker 0.1.7 开始；0.1.6 及更早版本会将该收款视为覆盖全部 SG 金额，并在注意事项中说明这一点）。每个收款日期都应提供基金收到的金额。依赖任何输出前，均须由人工审核。

从这里开始： 各组件的说明 · MCP 客户端设置 · 工具参考 · 范围、限制和示例

Ryan Duguid 不是注册税务代理或 BAS 代理。项目支持仅限于使用虚构数据复现的软件问题。请勿发送纳税人信息，也勿要求提供建议、准备申报表、确认税务处理方式或提交材料。

合成示例。会计判断由审核人员作出。

输入： 2026 年 8 月 6 日发薪日的 $120 养老金供款，8 月 14 日汇出，截至 8 月 20 日没有基金收款凭证。

试算一笔供款

安装好 uv 后，将合成 CSV 文件下载为 timely_remittance_no_receipt.csv。在该文件所在文件夹中打开终端并运行：

uvx --from payday-super-checker==0.1.7 payday-super-check timely_remittance_no_receipt.csv --as-at 2026-08-20 --confirm-remittance-only -o payday-report.csv

此操作会从 PyPI 下载固定版本的软件包，无需克隆代码仓库。它会在当前文件夹中生成 payday-report.csv；如果该文件已存在，则会覆盖。打开报告即可查看到期日和判定结果。

此确认表示已注意到缺少收款凭证；它并不能证明已付款。省略 --confirm-remittance-only，即可看到相同的 AT_RISK 结果和退出码 2，这表示你需要解决或确认这一证据缺口。

输出： AT_RISK，到期日为 2026 年 8 月 17 日；退出码 0 表示确认了仅有汇款凭证这一情况，但不能证明款项及时到账。

证据	结果	人工决定
截止日期前已汇款；缺少收款凭证	`AT_RISK`	在判定为按时之前，获取基金收款凭证。
记录显示基金于 8 月 17 日收到全额 $120 供款	根据所提供的事实为 `ON_TIME`	确认凭证以及任何适用的时限例外。

阅读 5 分钟 Payday Super 案例 · Division 7A 还款案例 · MCP 设置

已记录的公开评估使用的是 0.1.3 版本。按照其固定修订版本和命令重现该历史运行；上方的快速试用使用 0.1.7 版本，该版本要求提供有证据支持的金额以及基金收款日期。

选择下一个示例

您的任务	从这里开始
BAS 套件审查	两个合成套件及预期发现
Xero Activity Statement 交易 GST 审查	BAS 工作流和交易流程
月末结账	存在未解决异常的平衡试算平衡表
GST 规划	浏览器规划计算器
Division 7A	还款断言和审查边界
其他引擎和 Agent 工作流	示例和复现路径

对于交易 GST 编码，请加载链接的 bas-preparation 技能及其捆绑的交易参考资料。这些资料要求覆盖每一行，并分别提供供应处理、买方抵免和 BAS 归属的证据。Aus Accounting MCP 不提供交易 GST 分类器；其计算或控制账户勾稽无法证明税务编码正确。缺失的事实仍需由获授权的审查人员处理。该演练说明如何向 Codex、ChatGPT 和 Copilot 提供指令文件，但不声称三者经过测试的行为等效。

安装、组件标识、集成和参考资料

Aus Accounting MCP 应用及 7 个独立发布的澳大利亚会计引擎的开发主页。每个组件都有自己的分发名称、版本、锁文件、测试、发行说明、命令和许可证。没有根分发包、共享运行时库或统一版本。

使用 Aus Accounting MCP

对于 MCP 服务，请安装 Python 3.14+ 和 uv，然后将 MCP 客户端配置为运行：

uvx aus-accounting-mcp

这会启动一个本地 stdio 服务；它会等待 MCP 客户端连接，而不会打开网页。它不需要 API 密钥。安装软件包时会下载依赖项；之后工具使用随附的数据，不会发起网络请求或写入记录。你连接的 MCP 主机是一个独立的边界：它会将每个工具参数和结果发送给其模型提供商，因此请在托管模型中使用虚构数据。

uvx 会继续使用首次下载的版本，因此新版本不会自动生效。若要升级到某个版本，请在客户端配置中指定该版本，例如从 PyPI 获取的 aus-accounting-mcp==<version>；uvx 会下载该版本，之后的启动会复用缓存副本，不再下载，直到清理 uv 缓存为止。

合成 BAS 输出和 Division 7A 贷款审查的静态终端演示

连接成功后，用日常语言向助手提问。以下每个虚构请求都会调用一个工具：

提问	工具
“将一家销售额为 $180,000、无其他收入、工资支出 $60,000、租金 $30,000、其他支出 $40,000 的美发店与 ATO 基准进行比较。”	`get_ato_benchmarks`
“2026 年 8 月 6 日发薪日对应的养老金为 $120，并于 8 月 14 日汇出。截至 8 月 20 日，这笔款项是否按时？”	`calc_payday_super_deadline`
“2026-27 年度 Division 7A 基准利率是多少？”	`get_div7a_benchmark_rate`
“一名提供了 TFN 并申报免税门槛（scale 2）的员工，在 2026-27 年度每周领取固定工资 $1,000，没有抵免、贷款、奖金或其他调整。应预扣多少 PAYG？”	`calculate_tax_worksheet`

客户端设置和示例 · 工具参考 · PyPI · Glama 列表

这些工具可列出 ATO 基准行业、比较所提供的支出类别、审查 Payday Super 时限、查询经审查的 Division 7A 利率、审查由操作人员提供的 Division 7A 贷款、拒绝处理不受支持的 Division 7A 事项，以及生成合成 CTR/BAS 样本数据。它们还会评估相关的 Payday 缴款、计算 14 项范围有限的税务和养老金工作表，并检索带引用的本地 Markdown 摘录。Division 7A 审查仅限受委托引擎的 s 109N/s 109E 范围；不会合并贷款，也不会根据 s 109R 对还款进行分类。输出仅供审查参考，并非建议或申报文件。

如需安装可编辑的源代码，请在 apps/aus-accounting-mcp/ 中运行 pip install -e .。仓库根目录不是可安装的 Python 软件包。

组件

路径	分发包	导入包	命令
`packages/australian-tax-calculators/`	`australian-tax-calculators`（Rust）	无	`australian-tax-calculators`（JSON 标准输入工作表）
`apps/aus-accounting-mcp/`	`aus-accounting-mcp`	`aus_accounting_mcp`	`aus-accounting-mcp`、`aus-accounting-mcp-demo`
`packages/ato-benchmark-compare/`	`ato-benchmark-compare`（Rust）	无	`ato-benchmark-compare`
`packages/payday-super-checker/`	`payday-super-checker`（Rust）	无	`payday-super-check`
`packages/div7a-loan-review/`	`div7a-loan-review`（Rust）	无	`div7a-loan-review`
`packages/the-exchequer-tally/`	`the-exchequer-tally`（Rust）	无	`the-exchequer-tally`
`packages/solomons-sword/`	`solomons-sword`（Rust）	无	`solomons-sword`
`packages/the-wip-tally/`	`the-wip-tally`（Rust）	无	`wip-tally`
`apps/au-accounting/`	`au-accounting`（Rust）	无	`au-accounting`，每个 Rust 引擎对应一个子命令
`packages/gst-review/`	`gst-review`（Rust）	无	`gst-review`：根据注册状态检查 GST 编码，并将 BAS 与账簿进行对账
`packages/lodgment-calendar/`	`lodgment-calendar`（尚未发布）	`lodgmentcalendar`	Python 函数：提供 BAS、IAS 和所得税申报表的 ATO 申报计划到期日；缺少事实时返回 `UNKNOWN`
`apps/lodgeit-calculator-adapter/`	`lodgeit-calculator-adapter`（Rust，未发布）	无	`lodgeit-adapter`：第三方计算器服务的可选适配器；默认关闭，仅在启用时进行 HTTP 调用（`LODGEIT_ADAPTER_ENABLED=1` 或 `--enable-network`）
`packages/au-tax-rates-data/`	`au-tax-rates-data`（Rust，从未发布）	无	`rates validate`、`snapshot`、`check` 和 `ato-tables`：提供 ATO 税率和门槛，附原文引用，并支持离线验证

IMPORTS.md 记录了每个导入组件的源代码库、提交和树。MCP 应用是 io.github.ryanduguid/aus-accounting MCP Registry 服务；它依赖已发布的 ato-benchmark-compare、payday-super-checker、div7a-loan-review、australian-tax-calculators 和 gst-review 分发包。在开发工作区中，uv 从 PyPI 获取 gst-review 0.1.0、australian-tax-calculators 0.2.0、div7a-loan-review 0.3.2、ato-benchmark-compare 0.2.2 和 payday-super-checker 0.2.2，这些是它们最后发布的 Python 版本。

uv 工作区继续开发 Python 引擎和应用；MCP 服务目前尚未使用任何 Rust crate。

安装 Rust 引擎

这 8 个 Rust 引擎是尚未发布的独立二进制文件。使用 Rust 1.99 或更高版本，可安装 au-accounting，它通过子命令提供每个引擎的功能（benchmarks、div7a、exchequer、payday-super、gst-review、solomons、tax 和 wip）：

cargo install --locked --git https://github.com/ryanduguid/australian-accounting au-accounting

随后，au-accounting div7a --help 会显示该引擎自己的命令；请参阅其 README。若要改为安装某个引擎自己的命令，请使用上表中的 crate 名称，例如：

cargo install --locked --git https://github.com/ryanduguid/australian-accounting div7a-loan-review

au-accounting gst-review review-coding 和 reconcile-bas 从标准输入读取 JSON；请参阅 GST Review 架构。

预编译二进制文件即将推出：CI 已为每个 crate 构建 Windows、macOS 和 Linux 归档包，而且每个 crate 都包含 cargo-binstall 元数据，用于指定这些发布资源。目前尚无发布版本提供这些文件；需要先为 Rust 二进制文件和 crates.io 上的 crate 配置 Release Policy 工作流。两者发布后，以下命令将下载预编译二进制文件，而不是进行编译：

cargo binstall au-accounting

在组件中工作

进入组件目录，并使用其 README.md、 AGENTS.md 或 CONTRIBUTING.md 中记录的命令。根目录的 CONTRIBUTING.md 会指引常用命令，并说明运行这些命令的根工作流。

若要跳过本地设置，可在 GitHub Codespaces 中打开此仓库。 devcontainer 会安装 uv 并运行 uv sync --locked，因此上面的虚构示例可按原样运行。使用 Codespaces 会占用你自己的 GitHub 配额。

边界

MCP 应用仅通过引擎发布的发行包依赖引擎。
引擎不会导入 aus_accounting_mcp 或其他引擎，且没有生产模块使用会离开其包的相对导入；tests/test_boundaries.py 会验证这两点。
只有根目录 .github/workflows/ 下的工作流处于启用状态；组件目录中没有工作流。
本仓库不会存放客户数据、凭据或生成的客户报告。

发布

每个组件都由其自身的根工作流 .github/workflows/release-<component>.yml，使用带命名空间的标签 <component>/vX.Y.Z 单独发布。该工作流只会调用适用于该组件目录的固定版本 Release Policy 可复用工作流。CONTRIBUTING.md 中有相应表格。 packages/au-tax-rates-data/ 中的税率数据集永不发布。

每个组件的 LICENSE 适用于该组件；packages/ato-benchmark-compare/NOTICE 和 packages/au-tax-rates-data/NOTICE 涵盖其 ATO 材料。输出仅供审阅参考，并非建议。

_{Solomon Grundy，周一出生，周日完成对账。
由 Ryan Duguid 于澳大利亚纽卡斯尔制作。}

支持 Markdown

登录后评论