kalkulatory-place

Kalkulatory Płace — MCP サーバー

AI アシスタント向けのポーランド給与計算です。 5 つの MCP ツールが、「総支給額 11 600 PLN から手取りはいくら？」という質問を、推測ではなく、実際の銀行振込額と 1 グロシュ単位まで一致する回答に変えます。

今日、モデルにこの質問をすると、記憶を頼りに計算します。ポーランドの PIT と ZUS の税率は毎年変わり、所得税の前払い額はズウォティ単位に丸められ、健康保険料には法定上限があるため、回答は気付かないうちに間違ってしまいます。このサーバーは、kalkulatory-place.pl の表示にも使われているのと同じエンジンから計算済みの回答をモデルに渡すため、チャット内の数値とリンク先ページの数値が一致します。

API キー不要。レート制限なし。npm の依存関係なし。

インストール

claude mcp add kalkulatory-place -- npx -y @kalkulatory-place/mcp

その他の MCP クライアント（claude_desktop_config.json など）：

{
  "mcpServers": {
    "kalkulatory-place": {
      "command": "npx",
      "args": ["-y", "@kalkulatory-place/mcp"]
    }
  }
}

ツール

ツール	回答内容
brutto_na_netto	総支給額から手取り額を計算 — 雇用契約（ZUS、健康保険料、所得税の前払い額の内訳）、民法上の契約、雇用主負担額、26 歳未満の免税、年間合計
netto_na_brutto	指定した手取り額を得るために必要な総支給額
stawka_godzinowa	時給の総額から手取り額を計算 — 民法上の契約および雇用
stawki_roku	指定した年の最低賃金、非課税枠、PIT 税率区分、ZUS 税率、30 倍上限
katalog	対応年、金額の範囲、API URL のパターン

すべての応答には、stanPrawnyNa（法律を確認した日付）、statusRocznika （final または projekt — その年の税率がまだ法案の段階であることを示します）、および 人が読める詳細な内訳の URL である zrodlo が含まれます。

仕組み

静的な JSON API を利用するシンプルなクライアントです。CDN から通常の GET リクエストを送信し、キーも制限もありません。

MCP client ──stdio JSON-RPC──▶ this server ──HTTPS GET──▶ /api/v1/…json (CDN)

エンジンを複製せず、シンプルなクライアントにしている理由。 数値は、ユーザーが zrodlo をクリックした後に表示される内容と一致しなければなりません。サーバーが独自に計算すると、上流の税率が変わったときに、数値が気付かないうちに食い違ってしまいます。そして、その誤った数値を見せられた人が、食い違いに気付くことになります。

依存関係がない理由。 MCP は、改行区切りの JSON-RPC 2.0 として stdio 経由で直接処理します。dependencies のないパッケージなら npx から約 1 秒で起動でき、誰もが忘れてしまったサーバー上で他社の SDK が更新されても、影響を受けません。

基盤となる API は公開されており、OpenAPI 3.1 でドキュメント化されています： https://kalkulatory-place.pl/openapi.json。llms.txt もあります。

設定

変数	デフォルト値	用途
KALKULATORY_API	https://kalkulatory-place.pl	ベース URL — テスト時にはローカルビルドを指定します

テスト

npm test

公開サーバーに対して実際にハンドシェイクを実行します：initialize、tools/list、続いて brutto_na_netto の呼び出しを行い、結果を公開されている手取り額と照合します。

ライセンス

コード：MIT。データと計算：CC BY 4.0 — 数値を引用する場合は、zrodlo の URL を記載してください。NOTICE を参照してください。

これは税務アドバイスではありません。数値は情報提供を目的としています。

---

ポーランド語

ポーランドの給与を計算する MCP サーバーです。PIT と ZUS の税率を記憶から推測する代わりに、AI アシスタントへ 5 つのツールを提供します。

回答は kalkulatory-place.pl から取得しています。サービスのページを表示するものと同じ計算エンジンを使用しているため、チャット内の金額は、ユーザーがソースへのリンクをクリックした後に表示される金額と、1 グロシュ単位まで一致します。

ツール	回答する内容
brutto_na_netto	X ズウォティの総支給額から手取りはいくらか — 雇用契約（保険料の内訳付き）、委託契約、特定作品契約、雇用主負担額、26 歳未満の税額控除、年間合計
netto_na_brutto	雇用契約で X ズウォティの手取り額を得るには、総支給額はいくらか
stawka_godzinowa	時給 X ズウォティから手取りはいくらか — 委託契約と雇用契約
stawki_roku	最低賃金、非課税枠、PIT の税率区分、ZUS 保険料率、30 倍上限
katalog	対応する年次と金額の範囲

各回答には、stanPrawnyNa、statusRocznika（final または projekt — 年次の法令がまだ成立していない場合）、および人が確認できる詳細な内訳ページの URL である zrodlo が含まれます。

API キーも依存関係も不要なインストール：

claude mcp add kalkulatory-place -- npx -y @kalkulatory-place/mcp

提供元：Bril Brothers Innovation Labs sp. z o.o.、KRS 0001262781。 本サービスは税務アドバイザーではありません。計算結果は情報提供を目的としたものです。