MokaKit MCP 接入

端点已上线受限开发者预览

让你的 AI 助手（Claude、Cursor、自研 Agent）直接调用摩卡工具箱里的中国本土计算工具—— 个税、五险一金、增值税、房贷月供与提前还款，以及退休年龄、税后工资、存款利息、契税、加班工资与养老金测算。基于Model Context Protocol（Streamable HTTP 传输），人和 AI 都能调。

1. 端点与协议

端点 https://www.mokakit.com/mcp传输 Streamable HTTP (JSON-RPC 2.0)协议版本 2025-06-18 / 2024-11-05API 版本 v1

POST 请求走 JSON-RPC；首次 initialize 后从响应头取Mcp-Session-Id，后续请求需带上该头。GET 该端点返回 405，不携带合法 Bearer Token 的 POST 返回 401。

2. 鉴权

端点采用 Bearer Token 鉴权。当前为受限开发者预览：正式公开注册开放前，请通过下面的邮箱申请试用 Token（我们会回函告知你的专属 Token）。

申请接入 Token 查看隐私承诺

3. 快速开始（curl）

3.1 初始化会话

curl -X POST https://www.mokakit.com/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -d '{ "jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-client","version":"1.0"}} }'

3.2 列出工具

curl -X POST https://www.mokakit.com/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Mcp-Session-Id: <SESSION_ID>" \
  -d '{ "jsonrpc":"2.0","id":2,"method":"tools/list"} }'

3.3 调用工具（年入 30 万个税）

curl -X POST https://www.mokakit.com/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Mcp-Session-Id: <SESSION_ID>" \
  -d '{ "jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"income_tax_cn","arguments":{"annualGross":300000}}} }'

4. 客户端配置

支持 Streamable HTTP 的客户端（Claude Desktop、Cursor、VS Code 等）直接填 URL + 请求头即可。

{
  "mcpServers": {
    "mokakit": {
      "url": "https://www.mokakit.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

配置文件位置：Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json； Cursor .cursor/mcp.json；VS Code .vscode/mcp.json。

5. 可用工具（15）

tool name	说明
mokakit_search	在全部工具中按关键词检索（search-first 入口），返回工具 id/名称/链接；配有计算型工具时附带 mcpTool 名。
income_tax_cn	中国综合所得（工资薪金）年度个税：输入年税前收入、三险一金、专项附加等，输出税额、税率、到手收入、实际税负率。
bonus_tax_cn	年终奖单独计税（2024–2027 延续政策）：输入奖金，输出税额、税率、到手，并提示税率跳档盲区。
bonus_compare_cn	年终奖「单独计税 vs 并入综合所得」对比：输入奖金与综合所得应纳税所得额，输出更优方案。
social_security_cn	五险一金计算：输入缴费基数（可含上下限与自定义费率），输出个人/单位各项缴纳额与合计。
vat_general_cn	增值税一般计税（一般纳税人）：销项 − 进项，输出净额、本期应纳与留抵税额。
vat_simple_cn	增值税简易计税（小规模/特定业务）：不含税销售额 × 征收率，输出税额。
mortgage_schedule_cn	房贷还款计划（商贷/公积金）：等额本息或等额本金，输出月供、总利息、总还款与逐期明细。
mortgage_early_repayment_cn	房贷提前还款测算：对比「减少月供」与「缩短期限」，输出节省利息与新月供/新期数。
retirement_age_cn	退休年龄测算：依据渐进式延迟退休政策，输入出生年月与人员类别，输出法定退休年龄、延迟月数与退休年月。
after_tax_salary_cn	税后工资计算器：正算税前→税后，或反推税后→税前；按综合所得年度税率表，输出月个税、税后月薪与年薪。
deposit_interest_cn	存款利息计算器：支持一次性付息（单利）、自动转存（复利）与按月付息，输出利息金额与到期本息合计。
deed_tax_cn	契税计算器：输入成交价、面积与住房套数（首套/二套/三套），按契税优惠政策测算税率与应缴税额，支持含税价剔除。
overtime_pay_cn	加班工资计算器：工作日 150%、休息日 200%、法定节假日 300%，输出日工资、小时工资与加班费合计。
pension_estimate_cn	养老金测算：输入退休年龄、社平工资、缴费指数、缴费年限与个人账户余额，估算月领/年领养老金与替代率。

6. 版本与公开前状态

✓版本策略：当前 v1，端点路径 /mcp。破坏性变更走 /mcp/v2（已预留），不破坏 v1 客户端。
✓端点：HTTPS 已上线，Bearer Token 鉴权已启用。
⏳公开注册：开放前需先建立申请/发放通道（当前为受限预览）。
⏳工具冻结：公开后 tool name / schema 变更会破坏已接入的客户端，需走版本化或提前公告。

想提前接入？

发邮件到 wangcai@mokakit.com，主题注明「MCP 接入申请」，我们会回函发放试用 Token 与对接支持。