在你的 AI 助理裡算薪資

把 taiwan-payroll 的 MCP（Model Context Protocol）server 接上 Claude、Cursor 等支援 MCP 的 AI 助理，就能用自然語言問勞健保、勞退、二代健保補充保費、薪資扣繳與勞保老年給付——由對官方範例逐位元驗證的同一套引擎即時算出。

兩種連線方式

擇一即可。遠端端點免安裝、開箱即用；本地 stdio 則完全在你的機器上跑。

① 遠端 Streamable HTTP · 免安裝

支援原生 remote MCP 的 client，直接填入端點 URL：

https://taiwan-payroll.simoko.workers.dev/mcp

{
  "mcpServers": {
    "taiwan-payroll": {
      "type": "streamable-http",
      "url": "https://taiwan-payroll.simoko.workers.dev/mcp"
    }
  }
}

端點無狀態、無需登入；計算純在 edge 執行，不蒐集輸入資料。

② 本地 stdio · npx

不想連遠端、想完全離線在本機跑，用 npx 啟動：

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

Claude Desktop

編輯設定檔（macOS：~/Library/Application Support/Claude/claude_desktop_config.json），把上面任一段 mcpServers 貼進去後重啟。

Cursor

於專案 .cursor/mcp.json 或全域 ~/.cursor/mcp.json 加入相同的 mcpServers 設定。

Smithery · 一鍵安裝

透過第三方目錄一鍵安裝到支援的 client： smithery.ai/servers/supra126/taiwan-payroll。

官方 MCP Registry

已上架官方 Registry，條目 io.github.supra126/taiwan-payroll（遠端 streamable-http 與 npm stdio 雙軌）。

連線後 AI 助理可呼叫以下 9 個工具，皆為唯讀試算、不寫入任何資料：

calculate_payroll勞保＋健保＋勞退＋職災各方負擔

calculate_supplementary_premium二代健保補充保費（六類所得）

calculate_employer_supplementary_premium雇主端二代健保補充保費

calculate_income_tax_withholding薪資所得稅扣繳

calculate_old_age_pension勞保老年年金（月領，擇優兩式）

calculate_old_age_lump_sum勞保老年一次金

calculate_old_age_single_payment一次請領老年給付（舊制基數）

calculate_prorated月中到職／離職破月（健保月底歸屬）

list_years列出可用年度、資料版本、基本工資

試算結果僅供參考，實際應繳金額以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。函數層級的完整參數與回傳結構見 API 參考。