Calcuris

calcuris-mcp

一个 MCP（Model Context Protocol）服务，提供 Calcuris 背后的税务计算引擎——真实的 2026 年美国所得税和薪资计算、美国各州房产税、加拿大联邦及省级所得税、澳大利亚所得税和印花税，以及英国股息税。无需 API 密钥，也不会进行网络调用：所有数值均在本地计算，数据来源包括 IRS、Tax Foundation、CRA/Revenu Québec、ATO、各州税务部门和 HMRC。

快速开始

直接使用 npx 运行——无需安装。

Claude Desktop / Claude Code

添加到 MCP 配置（claude_desktop_config.json 或 .mcp.json）：

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

Cursor

添加到 .cursor/mcp.json：

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

工具

每个响应都包含 source 说明和 reference_url，指向使用相同引擎的 calcuris.com 在线计算器。

工具	描述	调用示例	响应示例（摘录）
us_income_tax	美国联邦税（2026 年 IRS 税率档，OBBBA 生效后）及预估州所得税，并提供完整的累进税率档明细。	{ "grossIncome": 95000, "filingStatus": "single", "stateCode": "CA" }	{ "federalTax": 12070, "stateTax": 4758.42, "totalTax": 16828.42, "marginalRate": 0.22, "takeHome": 78171.58 }
us_paycheck	美国每个发薪周期的实得工资：联邦预扣税、社会保障税、Medicare 税（含额外 Medicare 税）、州税和税后工资。	{ "payType": "salary", "annualSalary": 80000, "payFrequency": "biweekly", "filingStatus": "single", "stateCode": "TX" }	{ "net": { "annual": 65110, "perPeriod": 2504.23 }, "federal": { "annual": 8770 }, "socialSecurity": { "annual": 4960 } }
us_property_tax	根据房屋价值及自定义税率或所在州真实的 2026 年有效税率，计算年度／月度房产税。	{ "homeValue": 450000, "stateCode": "TX" }	{ "annualTax": 6300, "monthlyTax": 525, "effectiveRatePct": 1.4 }
ca_income_tax	加拿大联邦及省／地区所得税、CPP/QPP（含 CPP2/QPP2）、EI/QPIP，以及税后实得收入。可选 compareAllProvinces。	{ "grossIncome": 75000, "provinceCode": "ON", "rrspContribution": 0 }	{ "federalTax": 8468.74, "provincialTax": 3696.06, "netIncome": 57465.69 }
au_income_tax	澳大利亚居民所得税（2025-26 年 ATO 税率档）及 Medicare 税、Medicare Levy Surcharge、LITO 抵免、HELP/HECS 还款。	{ "taxableIncome": 95000, "privateHospitalCover": true, "hasHelpDebt": false }	{ "incomeTax": 19288, "medicareLevy": 1900, "totalTax": 21188, "takeHome": 73812 }
au_stamp_duty	澳大利亚各州／地区的印花税，包括首次购房者优惠和外国买家附加税。可选 compareAllStates。	{ "propertyValue": 750000, "stateCode": "NSW", "firstHomeBuyer": false, "foreignResident": false, "principalResidence": true }	{ "baseDuty": 28162.5, "totalDuty": 28162.5, "effectiveRate": 3.755 }
uk_dividend_tax	英国股息税，采用 HMRC 的叠加计算方式（股息计入其他收入之上），并考虑递减的个人免税额、£500 股息免税额，以及同比比较。	{ "otherIncome": 40000, "dividends": 15000, "year": "2026/27" }	{ "dividendTax": 2741.25, "totalTax": 8227.25, "extraVsPrior": 290 }

每个工具的 inputSchema 都记录了所有字段（类型、枚举值、默认值），并可通过 tools/list 发现——完整参数集请参阅 src/index.ts 中的源代码。

数据来源与时效性

所有引擎均以 2026 纳税年度 为目标（英国：2026/27，并内置 2025/26 年对比数据）。税率和税档来源如下：

• 美国 — IRS Rev. Proc. 2025-32（联邦税档、标准扣除额、儿童税收抵免）、SSA/IRS FICA 工资基数和税率、Tax Foundation（州所得税税档和房产税有效税率）、各州税务部门。
• 加拿大 — CRA（联邦税档、BPA、CPP/CPP2）、Revenu Québec（QPP、QPIP、魁北克减税）、各省财政部。
• 澳大利亚 — ATO（2025-26 个人所得税税率、Medicare levy、LITO、HELP/HECS 还款门槛）、各州和领地税务部门（印花税税率表和首次购房者优惠）。
• 英国 — HMRC（2025/26 和 2026/27 的个人免税额、股息免税额、所得税档和股息税率）。

这些数据集也用于支持以下实时计算器：

• calcuris.com
• 美国所得税计算器
• 美国工资单计算器
• 加拿大所得税计算器
• 澳大利亚印花税计算器

免责声明

结果仅为参考估算，不构成税务、法律或财务建议。税务情况因人而异（地方税、扣除额、抵免额和特殊情况并未全部纳入模型）。在做出财务决策前，请务必向合格的税务专业人士或相关政府机构核实数据。

开发

npm install
npm run build   # compiles src/ → dist/ with tsc
npm test        # spawns the built server and runs the smoke test

许可证

MIT © 2026 tresor4k