中国社保与薪税计算器 MCP Server (China Shebao & Payroll Tax MCP)

社保薪税通 (shebao.org) 是中国领先的纯前端无状态薪税、五险一金与社保政策计算平台，提供全国 31 个省市自治区官方政策、392 个地级及以上城市五险一金标准与个人所得税智能测算引擎。

本仓库是社保薪税通的官方 Model Context Protocol (MCP) 开源集成：

1. 远程 Streamable HTTP 服务端点（推荐，零安装免鉴权）：https://www.shebao.org/mcp

2. 轻量本地 stdio 桥接工具：npx -y github:ddter/china-shebao-mcp，为仅支持本地进程的客户端提供极速转发。

快速接入 (Quick Start)

方案一：远程 Streamable HTTP（推荐，免安装）

直接将支持 Streamable HTTP (协议版本 2025-06-18 / 2025-03-26 / 2026-07-28) 的客户端指向端点：

https://www.shebao.org/mcp

1. Claude Code

claude mcp add --transport http china-shebao https://www.shebao.org/mcp

2. Cursor / VS Code / Windsurf (.cursor/mcp.json 或 mcp.json)

{
  "mcpServers": {
    "china-shebao": {
      "url": "https://www.shebao.org/mcp"
    }
  }
}

3. OpenAI Codex CLI (~/.codex/config.toml)

[mcp_servers.china-shebao]
url = "https://www.shebao.org/mcp"

4. ChatGPT Custom GPT Actions

在 GPT 编辑器中点击 Configure → Create new action，在 Import from URL 填入：

https://www.shebao.org/openapi.json

即可一键导入全量薪税社保测算接口。

方案二：本地 stdio 桥接脚手架

针对部分只支持 stdio 标准输入输出的客户端（例如 Claude Desktop），在 claude_desktop_config.json 中配置：

{
  "mcpServers": {
    "china-shebao": {
      "command": "npx",
      "args": ["-y", "github:ddter/china-shebao-mcp"]
    }
  }
}

Related MCP server: PayHub MCP Server

提供的 6 大核心测算工具 (Tools)

示例对话场景 (Example Prompts)

• 场景 1（查政策）：“帮我查一下 2026 年北京最新的社保缴费基数上下限和官方发文依据。”

• 场景 2（算到手）：“我在上海月薪 15,000 元，公积金缴 7%，每月专项附加扣除 1,500 元，税后能拿到手多少？五险一金公司和个人各交多少？”

• 场景 3（年终奖筹划）：“全年工资 18 万，年底发 5 万元年终奖，应该单独计税还是并入综合所得更划算？能帮我算出税额差异吗？”

• 场景 4（养老金退休试算）：“计发基数 8,000 元，累计工龄 25 年，个人账户累计 12 万元，60 岁退休每月能领多少养老金？”

数据准确性与合规说明

1. 官方核验覆盖：全国 392 个城市的社保缴费基数上下限均已与各省人社厅、医保局 2026 年度最新政策文件逐条核验，数据来源清晰可溯源至政府门户网站（*.gov.cn）。

2. 公积金核验透明度：重点城市公积金基数与默认缴存比例已核验官方通知，未核验城市统一采用推荐比例（5%）明确试算边界。

3. 隐私安全：全站无状态计算，不存储、不上传任何个人姓名、证件号码或薪酬明细。

4. 免责声明：测算结果仅供薪酬筹划与参考，实际扣缴与待遇发放以当地社保局、公积金中心及税务机关核定为准。

开源协议

本项目遵循 MIT License 开源协议。 官方网站：https://www.shebao.org/