Fiskalizimi — Albanian tax & payroll

fiskalizimi MCP 服务（al.square/fiskalizimi）

一个 MCP 服务，为 AI Agent 提供阿尔巴尼亚税务电子化和薪资相关的离线只读计算工具，基于 fiskalizimi-utils 构建，由 Square Software 维护。Square Software 是一家位于地拉那的软件公司，为 POS、ERP 和电子商务系统提供税务电子化集成。

无需网络访问，无需 API 密钥，不会有任何数据离开本机。

工具

工具	功能
validate_nipt	检查 NIPT/NUIS（M51418039H）格式、规范化分隔符、标记 O/0 和 I/1 的输入错误，并链接至 QKB 查询页面
add_vat / extract_vat	按任意税率计算 TVSH——阿尔巴尼亚为 20 / 10 / 6 %，科索沃为 18 / 8 %
invoice_totals	计算小计、VAT 和总计，并提供税务电子化发票必须列出的各税率 VAT 明细；支持按行折扣
net_salary	计算月薪税后金额：税前工资 → 税后工资；包括员工社保 9.5 % + 医疗保险 1.7 %、累进所得税 0 / 13 / 23 %、雇主成本
gross_salary_from_net	计算税前工资 → 税后工资，提供相同的明细
profit_tax	根据累进税档计算企业利润税（不超过 14,000,000 ALL 为 0 %，超出部分为 15 %）
tax_rates	经过核实的 AL-2026 配置：税率、上限、税档、截止日期、来源、核实日期和已披露的限制

资源：fiskalizimi://rates/AL-2026（JSON）。

这些数字与我们免费在线工具使用的数字一致——Verifikues NIPT、Llogaritësi i TVSH-së、Llogaritësi i pagës——并已于 2026-06-29 对照 tatime.gov.al 核实。在参考税后工资结果前，请先阅读 tax_rates 中的 notes，尤其是月薪处于 50,000–60,000 ALL 过渡区间时。

安装

Claude Desktop——从最新版本下载 fiskalizimi-mcp.mcpb 并打开。

任何 MCP 客户端（stdio）——在检出代码后运行：

git clone https://github.com/square-al/fiskalizimi-utils && cd fiskalizimi-utils
npm ci && npm run build
cd mcp && npm ci && npm run build

{
  "mcpServers": {
    "fiskalizimi": { "command": "node", "args": ["/path/to/fiskalizimi-utils/mcp/dist/main.js"] }
  }
}

或者运行 .mcpb 中附带的单文件包（它是一个 zip）：node server/index.js。

示例

“m5141 8039h 是有效的 NIPT 吗？税前工资为 120,000 lek 时，实际到手多少？”

validate_nipt  → { valid: true, normalized: "M51418039H", parts: { prefix: "M", … } }
net_salary     → { gross: 120000, empSocial: 11400, empHealth: 2040, incomeTax: 7352.8, net: 99207.2, employerCost: 140040, … }

开发

npm test          # in-memory client ↔ server round-trips
npm run bundle    # esbuild → bundle/ (single CommonJS file + manifest)
npx @anthropic-ai/mcpb pack bundle dist/fiskalizimi-mcp.mcpb

server.json 是官方注册表描述文件；仓库根目录中的 PUBLISHING.md 列出了发布步骤。

MIT © Square Software SHPK