kalkulatory-place

Kalkulatory Płace — MCP 服务

为 AI 助手提供波兰工资计算。 五个 MCP 工具，可将“税前工资 11 600 PLN，实际到手多少？”从猜测变成精确到分、与银行转账金额相符的答案。

现在向模型询问这个问题，它会凭记忆计算。波兰 PIT 和 ZUS 税率每年都会变化，所得税预缴款按整兹罗提取整，医疗保险缴款有法定上限，因此答案往往悄然出错。此服务会向模型提供预先计算好的答案，使用的计算引擎与 kalkulatory-place.pl 页面相同，因此聊天中的数字与链接页面上的数字完全一致。

无需 API 密钥。没有速率限制。无需 npm 依赖。

安装

claude mcp add kalkulatory-place -- npx -y @kalkulatory-place/mcp

其他 MCP 客户端（claude_desktop_config.json 等）：

{
  "mcpServers": {
    "kalkulatory-place": {
      "command": "npx",
      "args": ["-y", "@kalkulatory-place/mcp"]
    }
  }
}

工具

工具	可解答的问题
brutto_na_netto	根据税前金额计算税后工资 — 雇佣合同（逐项列出 ZUS、医疗保险、所得税预缴款）、民事法律合同、雇主成本、26 岁以下免税、年度总额
netto_na_brutto	计算要达到指定税后收入所需的税前工资
stawka_godzinowa	根据税前时薪计算税后收入 — 民事法律合同和雇佣合同
stawki_roku	指定年份的最低工资、免税额、PIT 税档、ZUS 税率、30 倍上限
katalog	支持的年份、金额范围、API URL 模式

每个响应都包含 stanPrawnyNa（法律核查日期）、statusRocznika（final 或 projekt — 当年税率仍是法案草案）以及 zrodlo，即完整易读明细的 URL。

工作原理

这是一个面向静态 JSON API 的轻量客户端：通过 CDN 发出普通 GET 请求，无需密钥，也没有限制。

MCP client ──stdio JSON-RPC──▶ this server ──HTTPS GET──▶ /api/v1/…json (CDN)

为什么采用轻量客户端，而不是复制计算引擎。 数字必须与用户点击 zrodlo 后看到的完全一致。若服务自行计算，上游税率一旦变化，结果就会悄然偏离 — 而看到错误数字的用户迟早会发现。

为什么没有依赖。 MCP 通过基于换行分帧的 JSON-RPC 2.0，直接在 stdio 上处理。没有 dependencies 的软件包通过 npx 启动只需约一秒，也不会因某个无人维护的服务所用 SDK 更新而出问题。

底层 API 公开且有 OpenAPI 3.1 文档： https://kalkulatory-place.pl/openapi.json。另有 llms.txt。

配置

变量	默认值	用途
KALKULATORY_API	https://kalkulatory-place.pl	基础 URL — 测试时可指向本地构建

测试

npm test

会与已发布的服务执行真实握手：initialize、tools/list，然后调用 brutto_na_netto，并将结果与已发布的税后金额进行核对。

许可证

代码：MIT。数据和计算：CC BY 4.0 — 引用数字时，请注明 zrodlo 中的 URL。参见 NOTICE。

这不是税务建议。数据仅供参考。

---

波兰语

用于计算波兰薪酬的 MCP 服务。它为 AI 助手提供五种工具，无需从记忆中猜测 PIT 和 ZUS 税率。

回答来自 kalkulatory-place.pl——使用与渲染该网站页面相同的引擎，因此聊天中的数字精确到分，与用户点击来源链接后看到的数字一致。

工具	回答的问题
brutto_na_netto	X 兹罗提税前工资对应多少税后工资——雇佣合同（含缴费明细）、委托合同、特定工作合同、雇主成本、26 岁以下减免、年度总额
netto_na_brutto	雇佣合同下，X 兹罗提税后工资对应多少税前工资
stawka_godzinowa	X 兹罗提/小时的费率对应多少税后工资——委托合同和雇佣合同
stawki_roku	最低工资、免税额、PIT 税率档、ZUS 缴费率、30 倍上限
katalog	支持的年份和金额范围

每个回答都包含 stanPrawnyNa、statusRocznika（final 或 projekt——该年份的规定尚未通过）以及 zrodlo，即包含完整明细的页面地址，方便用户查看。

无需 API 密钥，也无需安装依赖：

claude mcp add kalkulatory-place -- npx -y @kalkulatory-place/mcp

发布方：Bril Brothers Innovation Labs sp. z o.o.，KRS 0001262781。 本服务不提供税务咨询；计算结果仅供参考。