内容
# itr-mcp
[](https://www.npmjs.com/package/itr-mcp)
[](https://github.com/Sagargupta16/itr-mcp/actions/workflows/ci.yml)
[](LICENSE)
[](https://modelcontextprotocol.io)
本地优先的MCP服务器，用于印度所得税。向Claude提问您的税务问题，并获得在您的机器上计算的确定性答案 - 无需账户，无需上传，无需云。
与Claude Desktop、Claude Code和任何MCP客户端兼容。
```
您： 我的CTC是18L，雇主NPS是50K - 2025-26财年应该选择哪种制度？
Claude： [compare_regimes] 新制度：1,87,200。旧制度（有扣除）：2,10,600。
推荐：新制度，节省23,400卢比。
您： 如果我今年收获1.5L的长期股权收益？
Claude： [compute_tax] LTCG 1,50,000 - 1,25,000豁免 = 25,000应税按12.5％ = 3,125卢比 + 附加费。
```
## 为什么
每个印度税务工具都想要您的数据放在他们的服务器上。现有的金融MCP（Fi Money，INDmoney）是云托管的，并且不提供任何税务工具。itr-mcp则相反：您的文档保留在本地，LLM永远不会进行算术运算，每个数字都来自您可以审计的版本规则包。
## 工具（v0.2）
| 工具 | 功能 |
| --- | --- |
| `compute_tax` | 完整的2025-26财年（AY 2026-27）计算：新/旧制度税率，标准扣除，87A回扣与边际缓解（旧制度：总收入门槛，抵消111A），111A（20％）/ 112A（1.25L以上12.5％）资本利得，附加费与15％利得上限，4％附加费 |
| `compare_regimes` | 旧制度与新制度对比，推荐制度，节省金额 |
| `schedule_advance_tax` | 6月/9月/12月/3月分期付款计划（15/45/75/100％）与不足额跟踪 |
| `compute_interest_234` | 第234B/234C节利息与法定12％/36％安全港和规则119A四舍五入（本金下限100卢比，月末=整月） |
| `compute_hra` | 按规则2A计算HRA豁免，按期间（三个肢体中最小；2025-26财年大都市地区：德里/孟买/加尔各答/钦奈）+ 80GG替代 |
| `list_deductions` | 旧制度扣除清单与法定上限（80C，80CCD（1B），80D层级，HRA大都市地区） |
| `parse_form26as` | 将TRACES的Form 26AS文本导出解析为结构化的TDS条目 |
| `parse_ais` | 在设备上解密和解析AIS JSON导出（AES-256-CBC/PBKDF2，密码由PAN + DOB派生）；规范化行与标签匹配的金额/日期/代码 |
| `reconcile_documents` | Form 16 vs AIS vs 26AS不匹配报告 - 防止143（1）（a）通知和139（9）缺陷通知的检查（TDS超额申报，雇主缺失，未申报AIS利息/股息） |
| `list_tax_years` | 支持的财政年度 + AY 2026-27申报截止日期 |
所有工具都是只读的（`readOnlyHint: true`），并返回类型化的`structuredContent`。
## 安装
### Claude Code
```bash
claude mcp add itr-mcp -- npx -y itr-mcp
```
### Claude Desktop
添加到`claude_desktop_config.json`：
```json
{
"mcpServers": {
"itr-mcp": {
"command": "npx",
"args": ["-y", "itr-mcp"]
}
}
}
```
### 从源码
```bash
git clone https://github.com/Sagargupta16/itr-mcp
cd itr-mcp && pnpm install && pnpm build
node dist/index.js # stdio 服务器
```
## 示例提示
- "我的CTC是18L，雇主NPS是50K - 2025-26财年我应该选择哪种制度？"
- "我今年卖了3L的共同基金，长期收益是多少税？"
- "我的预计税是2.4L，TDS覆盖1.8L。计划我的预缴税分期。"
- "解析`C:/tax/26AS.txt`并合计我的雇主存入的TDS。"
## 设计原则
- **仅本地。**stdio传输，无网络调用，无遥测。您的PAN永远不会离开进程（并且在文本输出中被屏蔽）。AIS解密完全在设备上使用Node的crypto进行 - 逆向工程的密码方案具有无pepper的后备和显式`password`覆盖，以防格式旋转。
- **LLM永远不会进行数学运算。**每个卢比都是通过`data/fy2025-26.json`的纯函数计算的。黄金文件测试将引擎固定在已发布的示例上（12L零税情况，12,10,000边际缓解情况，12,70,588缓解耗尽点）。
- **按年份参数化。**规则存储在每个财政年度的JSON包中。2026-27财年（预算2026：Form 16更名为Form 130，8个HRA大都市，买回复位）作为新包落地，而不是代码更改。
- **不是税务建议。**每个回复都带有免责声明和规则包版本。在提交前请与官方实用工具核实。
## 路线图
- [x] **v0.1** -- 税务引擎（两种制度 + 资本利得 + 附加费 + 附加费），制度比较，预缴税，扣除清单，26AS文本解析器
- [x] **v0.2** -- `parse_ais`（加密AIS JSON，设备解密），`reconcile_documents`（#1-通知触发检查），234B/234C利息与黄金案例测试，HRA + 80GG计算器，旧制度87A语义修复
- [ ] **v0.3**（优先级根据实际AY 2026-27申报验证）-- `compute_loss_setoff`（BFLA/CFL引擎，[#4](https://github.com/Sagargupta16/itr-mcp/issues/4))，`recommend_itr_form`具有损失连续性意识（[#3](https://github.com/Sagargupta16/itr-mcp/issues/3)），`parse_form16`（TRACES PDF），经纪人资本利得解析器 - 先是Groww，然后是Zerodha（[#7](https://github.com/Sagargupta16/itr-mcp/issues/7)）
- [ ] **v0.4** -- `compute_schedule_fa`（外国资产/RSU，规则115费率，[#5](https://github.com/Sagargupta16/itr-mcp/issues/5)），门户怪癖攻略（[#6](https://github.com/Sagargupta16/itr-mcp/issues/6)），共同基金CAS通过casparser，草稿ITR JSON导出，`.mcpb`一键Claude Desktop捆绑，MCP注册列表
## 开发
```bash
pnpm install
pnpm test # vitest：引擎黄金文件 + 内存MCP客户端测试
pnpm build
pnpm inspect # MCP检查dist/index.js
```
## 免责声明
itr-mcp是一个开源计算器和文档解析器。它不是专业税务建议的替代品，并且它永远不会提交任何内容 - 输出意味着要与官方所得税实用工具核实。
## 许可证
[MIT](LICENSE)
