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

中国社会保険・給与税計算 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）

方法 1：リモート 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

これで、すべての給与税・社会保険試算インターフェースを一括でインポートできます。

---

方法 2：ローカル stdio ブリッジのセットアップ

標準入力・標準出力の stdio のみをサポートする一部のクライアント（Claude Desktop など）では、claude_desktop_config.json に次のように設定します：

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

---

提供する 6 つの主要な試算ツール（Tools）

ツール名	機能の説明	主な入力パラメーター
query_social_security_policy	31 の省・市の 2026 年公式社会保険基数の上限・下限、社会平均賃金、および文書の根拠を照会します	province（省名）
get_city_social_fund_limits	全国 392 都市の五険一金の基数上限・下限、既定の納付率、および公式確認状況を照会します	city（都市名または拼音 slug）
calculate_salary_take_home	月給・年収の税引後手取り額、五険一金の内訳、累計源泉徴収所得税、および 12 か月分のキャッシュフローを試算します	city, salary, fundRate, specialDeduction
calculate_income_tax	給与所得の累計源泉徴収、労務報酬の都度源泉徴収、年間総合所得の確定申告を計算します	type, amount, month, annualLabor
compare_annual_bonus_tax	年末賞与の単独課税と合算課税の 2 つの方法における所得税額と手取り額の差を比較し、最適な税務計画を提案します	annualSalary, bonus
calculate_retirement_pension	企業従業員基本養老保険の年金額（月額基礎年金＋個人口座年金）を試算します	pensionBase, years, accountBalance, retireAge

---

会話例（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/