dsh-hr-payroll-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@dsh-hr-payroll-mcpimport the March payroll Excel and run compute_payroll for all employees"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
dsh-hr-payroll-mcp
通用 HR 算薪 MCP 服务(零依赖 Node ESM,本地优先,PII 不出机)。
要解决的问题
各公司 HR 数据源表格格式不同(社保表、公积金表、绩效表…)、算薪规则与逻辑也不同。 本插件用三层架构把"差异"外部化,让引擎保持公司无关:
法定计算引擎(公司无关) — 社保/公积金/个税均为全国或市级法定标准,算法全国统一,是本插件的护城河/知识资产。
Import Adapter(通用表头适配) — 列名同义词推断 + 用户确认映射 + 类型校验 + 缺失告警。各企业表头差异在此消解,不进代码。
Company Profile(企业配置) — 属地/公积金比例/薪资拆分比/免税项字典/四舍五入/专项附加来源。各企业差异在此配置。
唯一真正需要企业自定的只有绩效逻辑:用受限表达式安全求值器(仅 + - * / % ( ) 与变量,非任意 eval)表达,或查表。既灵活又不会执行恶意代码。
Related MCP server: taiwan-payroll
差异化(诚实定位)
纵向 HR SaaS(薪人薪事/易路/钉钉智能人事等)确实存在,但它们要求 PII 上传云端。本插件完全本地计算,PII 不出机 —— 对数据安全敏感的 HR、需离线审计/复核、或想把算薪接入本地 AI 工作流的场景是空白。
开源 payroll 库多为某国税法特化(如美国 payroll 库),中国社保/公积金/个税累计预扣法 + 按城市比例 + 通用表头适配 + MCP stdio 可驱动的组合,公开仓库中基本空缺。
与 dsh 生态的关系:作为本地数据/计算层,被 dsh agent 调用,配合
dsh-cn-fixedincome-mcp等形成"本地优先"工具链。
工具清单(9 个)
工具 | 作用 |
| 表头适配:推断映射 + 置信度 + 未匹配/缺失告警 + 样例归一化 |
| 企业配置读写(仅存本机) |
| 五险一金:基数 clamps 上下限,按险种可单独指定缴费基数,单位/个人分项;工伤按 |
| 个税累计预扣法:本期税额 + 税率 |
| 算薪编排:拆分+绩效→应发→社保→个税→实发,累计 YTD;并输出 |
| 校验:应发/实发重组一致性、非负、税逻辑 |
| 导出工资条(CSV/JSON) |
| 参数库版本/覆盖城市(年度刷新提示) |
部署
安装(复制到本机):
C:\Users\helib\dsh-hr-payroll-mcp\在 dsh
cordis.patch.yml注入 mcp server(见仓库cordis.patch.yml)。注意:
cordis.patch.yml中的args/cwd写的是作者本机绝对路径,部署到你的机器需改成对应路径;或设置环境变量PAYROLL_STATUTORY/PAYROLL_SYNONYMS/PAYROLL_PROFILE指向你的文件。命令
!!js process.env.QUANT_MCP_NODE || process.execPath免疫 Node 版本目录漂移。
重要边界(免责)
参数库需年度刷新:社保/公积金比例与基数上下限每年由各地官方调整,
data/statutory.json当前为 2026 年度参考值(version2026-ref,覆盖 12 城:8 城已按 2026 官方通告更新,4 城待发布暂沿用 2025),使用前务必以属地当年官方文件为准。本插件仅供算法演示与离线计算,责任自负。工伤保险特殊说明:工伤仅单位缴纳,比例按行业风险一类~八类(约 0.2%~1.9%)由属地经办机构核定。它不进个人工资,但计入公司总人力成本——因此本插件不把它放在城市参数库,而是统一通过 Company Profile 的
injury_rate配置(calc_social_insurance/compute_payroll均接受该参数);compute_payroll还会在company_cost中给出公司总人力成本(应发 + 单位社保 + 单位公积金 + 单位工伤)。医保基数可能与养老不同:深圳、广州、杭州等城市的职工医保(含生育)缴费基数上下限与养老/失业不同,已在
statutory.json内按险种单独标注(base_floor/base_cap),引擎据此分项 clamps。2026 费率与执行日备注:广州/深圳 2025 年度医保单位费率含阶段性降费(深圳 5%、广州 5.35%),2026 年度已恢复至常规水平(深圳 6%、广州 6%+生育 0.85%);杭州基数分上下半年(1-6 月 4986-25299 / 7-12 月 5346-26730),本库按下半年现行值收录;天津 2026 基数执行日为 9 月 1 日(非 7 月);西安职工医保基数与养老基数分家(5132-25660 vs 4650-23250)。详细见
statutory.json各城_2026字段。绩效逻辑由用户自供:引擎只负责法定部分,绩效公式/查表由企业自行提供并确认。
未收录城市请用
refresh_statutory扩展或选用已收录城市(当前:北京/上海/深圳/广州/杭州/成都/武汉/天津/重庆/苏州/南京/西安)。
覆盖城市(12)
已更新至 2026-ref(8):北京 · 上海 · 天津 · 成都 · 杭州 · 深圳 · 广州 · 西安
待发布,暂沿用 2025-ref(4):武汉 · 南京 · 苏州 · 重庆
2026 数据来源:北京市人社局/医保局/税务局 2026.8.21 + 北京公积金中心 2026.8.24(京房公积金管委会办〔2026〕6号);上海市人社局 2026.8.18 + 上海公积金管委会 2026.8.18;天津市人社局/医保局/税务局 2026.8.21(执行日 2026-09-01);川人社办发〔2025〕39号;浙人社发〔2025〕52号 + 杭州市医保局 2025.12.23(杭州分上下半年两套基数);广东省人社厅(养老 2025.7-2026.6 周期)+ 深圳市医保局 2026 + 广州市医保局 2026.1(广深医保单位费率由阶段性降费恢复至常规水平);西安市医保局(市医保发〔2026〕36号)+ 陕西省税务局 2026.7.30(西安医保基数与养老分家)。武汉/南京/苏州/重庆 2026 新基数待官方发布。具体以各地官方公告为准。
授权
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Open-source AI accounting skills verified by licensed accountants (tax, VAT, payroll).
Deterministic Mexican payroll & tax math: finiquito, ISR, aguinaldo, IMSS (2026 tables).
Deterministic cross-border tax engine: PE, GAAR, Indian TP, rule-level lookup. Compiled law, no LLM.
ZATCA-compliant Saudi invoicing and accounting: invoices, receivables, VAT, ledger, payroll.
Related MCP Servers
- FlicenseAqualityCmaintenanceConnects Claude Desktop to the Paylocity API to manage employee records, pay statements, and company headcount data through natural language. It includes automated data protection that redacts sensitive information like SSNs and bank account numbers before reaching the model.8
- AlicenseAqualityBmaintenanceTaiwan statutory payroll calculation — labor & health insurance, labor pension, 2nd-gen NHI supplementary premium, income-tax withholding, and old-age benefits. Sourced from official gazettes, verified against official sample data.91MIT
- AlicenseAqualityBmaintenanceEnables AI tools to normalize messy payroll spreadsheets (xlsx/xls/csv) into a standardized 10-column template for social insurance calculation, with automatic column detection, net-to-gross conversion, and cross-entity/month merging.4MIT
- AlicenseAqualityCmaintenanceLocal-first MCP server for Indian income tax computation, enabling users to compute taxes, compare regimes, plan advance tax, and parse Form 26AS without sending data to the cloud.12208MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/helibeiqi/dsh-hr-payroll-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server