dsh-hr-payroll-mcp

每次发薪，HR 都要面对同样的头疼事：社保表把一列叫「缴费基数」，公积金表叫「缴存基数」，绩效表可能一个重名都没有。而算薪本身——个税累计预扣法、各城市基数上下限、工伤按行业风险类费率——散落在每年更新的几十份政策文件里。再叠加主流 HR SaaS 必须上传 PII 到云端这条红线，合规敏感的企业往往干脆拒绝使用。dsh-hr-payroll-mcp 把整条算薪流水线做成零依赖、本地优先的 Node ESM MCP 服务：所有计算在本机完成，数据不出机。

插件采用三层架构。底层是法定计算引擎，内置 12 城（北京、上海、深圳、广州、杭州、成都、武汉、天津、重庆、苏州、南京、西安）的社保/公积金/个税参数，支持按险种独立 clamps 基数上下限、工伤保险仅计入单位成本、逐月累计预扣个税。中间层是 Import Adapter，通过同义词推断列名映射、用户确认、类型校验与缺失告警，把各企业千差万别的表头在代码之外消解。顶层是 Company Profile，将公积金比例、薪资拆分比、专项附加扣除、四舍五入规则等企业专属参数外部化。绩效逻辑由受限表达式求值器处理，仅允许加减乘除、括号与变量，杜绝任意代码执行。共暴露 9 个 MCP 工具，覆盖表头适配、单项计算、算薪编排、一致性校验与工资条导出（CSV/JSON），可通过 MCP stdio 被 dsh agent 直接驱动。

三类用户最受益：一是对数据安全有硬性要求、拒绝 PII 上云的合规型 HR 团队；二是需要离线审计、复核或搭建算薪沙盒的财务与内审人员；三是希望把算薪嵌入本地 AI agent 工作流、与 dsh 生态其他工具串联的开发者。参数库标注为 2026 年度参考值并附各城来源文件，但正式使用前务必以属地当年官方公告为准。