Taiwan Payroll

Name: Taiwan Payroll
Author: supra126

@supra126

关于 Taiwan Payroll

Taiwan statutory payroll calculation — labor & health insurance, labor pension, 2nd-gen NHI supplementary premium, income-tax withholding, and labor-insurance old-age benefits. Sourced from official gazettes, verified against official sample data. TS (npm) + Python (PyPI) + MCP (

#taiwan #payroll #labor-insurance #health-insurance #pension #tax #finance

基本信息

分类

其他

传输方式

stdio

发布者

supra126

提交者

小黃黃

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "taiwan-payroll": {
      "command": "npx",
      "args": [
        "-y",
        "taiwan-payroll-mcp"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Taiwan Payroll?

Taiwan Payroll is an open-source calculation engine for Taiwan’s statutory labor insurance, health insurance, pension, occupational accident, and second-generation NHI supplementary premium. It supports multiple identities, pro‑rated calculations for mid‑month join/leave, generation of NHI supplementary premium filing CSV files, and old‑age pension benefit trials. The engine is available as TypeScript (npm), Python (PyPI), and an MCP server for AI assistants.

How to use Taiwan Payroll?

Install the core library via npm install taiwan-payroll or pip install taiwan-payroll. For AI assistants, use the MCP server remotely at https://taiwan-payroll.simoko.workers.dev/mcp (Streamable HTTP) or locally with npx taiwan-payroll-mcp (stdio). Call functions like createPayrollEngine({ year }) then engine.calculate(...) with salary and identity parameters.

Key features of Taiwan Payroll

Zero runtime dependencies in core packages.
Cross‑language consistency between TypeScript and Python.
Built‑in official parameters for years 2024–2026.
Generates NHI supplementary premium filing CSV (Big5).
Calculates old‑age pension benefits (annuity, lump sum, single payment).
Pro‑rated calculations follow official “end‑of‑month attribution” rule for health insurance.

Use cases of Taiwan Payroll

Compute employee and employer contributions for a given monthly salary and identity.
Pro‑rate labor insurance, pension, and health insurance for employees joining or leaving mid‑month.
Generate NHI supplementary premium filing files for all six categories.
Trial old‑age pension amounts (annuity, lump sum, single payment) based on official formulas.

FAQ from Taiwan Payroll

What calculations does Taiwan Payroll support?

It calculates labor insurance (including employment insurance), health insurance, pension, occupational accident premium, and second‑generation NHI supplementary premium for both employee and employer sides. It also handles pro‑rated amounts, supplementary premium filing, and old‑age pension benefits.

What are the runtime dependencies?

The core packages have zero runtime dependencies. The MCP server may require a Node.js runtime but no extra frameworks.

Which years are supported?

Taiwan Payroll includes built‑in parameters for the years 2024, 2025, and 2026. You can specify the year with createPayrollEngine({ year }) and list available years via getAvailableYears().

How can I use Taiwan Payroll as an MCP server with an AI assistant?

You can either use the remote Streamable HTTP endpoint (no local installation) or run the server locally with npx taiwan-payroll-mcp (stdio). The server is listed on the official MCP Registry, Smithery, and Glama.

Is the calculation legally guaranteed?

No. The engine is a reference implementation based on official tables and rates. Actual amounts are determined by the Labor Insurance Bureau and National Health Insurance Administration. Taiwan Payroll does not constitute legal or accounting advice.

其他分类下的更多 MCP 服务器

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K