Obolus

Obolus Finance API とリモート MCP の使用例

Obolus の給与計算および複数国の税務 API の公開サンプルです。このリポジトリには、小規模な Vite クライアント、接続例、ドキュメントが含まれています。ホストされている計算エンジンと MCP サーバーは obolusfinanz.de で稼働しており、そのサーバーのソースコードはこのリポジトリには含まれていません。

リモート MCP サーバー

Obolus は、公開の読み取り専用 MCP エンドポイントを提供しています。

• Streamable HTTP：https://www.obolusfinanz.de/api/mcp/claude
• ツール：単一国の詳細な給与計算用の berechne と、2 か国以上の比較用の taxcompare
• アクセス：これらの読み取り専用ツールの利用にログインや API キーは不要です
• レジストリ：io.github.sanzation/obolus
• API と MCP の全ドキュメント：Obolus Developers

/claude URL は、歴史的なルート名にかかわらず、エージェントに依存しない MCP インターフェースです。Claude 以外の MCP クライアントにも適しています。ブラウザー向けの ChatGPT アプリ統合（/api/mcp）とは別のものです。

VS Code / GitHub Copilot から接続する

このリポジトリには、ワークスペース用の .mcp.json が含まれています。VS Code でフォルダーを開き、MCP サーバーの一覧を開いて、obolus を起動してください。設定を自分のワークスペースにコピーすることもできます。

{
  "servers": {
    "obolus": {
      "type": "http",
      "url": "https://www.obolusfinanz.de/api/mcp/claude"
    }
  }
}

たとえば、エージェントに次のように尋ねます。「Obolus を使って、2026 年のドイツとオーストリアで、年間総支給額 EUR 60,000 を比較してください。」エージェントは詳細を勝手に作り上げず、不足しているプロフィール情報を尋ねる必要があります。計算結果は推定値です。結果を利用する前に、各ツールが返す前提条件と出典情報を確認してください。

計算を行わずに公開 MCP 接続を確認するには、npm run mcp:check を実行してください。利用可能なツールを一覧表示し、想定される両方のツールが存在することを確認します。

REST API デモ

Vite アプリは、POST /api/berechne と POST /api/taxcompare への REST 呼び出しを直接行う方法を示します。これは API クライアントであり、ローカル MCP サーバーや税務計算エンジンのコピーではありません。

npm install
npm run dev

http://localhost:8080 を開いてください。Vite プロキシが API リクエストを転送します。詳細は vite.config.js を参照してください。npm run build でビルドします。

最新かつ完全なリクエストスキーマとレスポンス例については、開発者向けページまたは OpenAPI ドキュメントを参照してください。ブラウザのデモでは、主要通貨単位を使う従来の annual_gross エイリアスを使用しています。新しい taxcompare 統合では、マイナー通貨単位を使う salary_ct を推奨します。currency が eur で、salary_period が annual の場合、6000000 は EUR 60,000 を意味します。少なくとも 2 か国と、サポート対象の税年度が必要です。詳細な berechne エンドポイントでも、給与フィールドにはマイナー通貨単位を使用します。

比較リクエストの例：

const response = await fetch("https://www.obolusfinanz.de/api/taxcompare", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    salary_ct: 6000000,
    salary_period: "annual",
    tax_year: "2026",
    countries: ["DE", "AT"],
    currency: "eur"
  })
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);

サポート対象の国は、ドイツ、オーストリア、スイス、米国、英国、アイルランド、カナダ、オーストラリアです。返される手取り額は、税金と給与計算に基づく結果です。住居費、食料品、給与計算に含まれない医療費、購買力調整は別のモデルです。給与計算上の手取り額を、生活費を差し引いた可処分所得として説明しないでください。

リポジトリの範囲と使用方法

これは公開された統合例であり、MCP サーバーのソースリポジトリではありません。ホストされている API には利用規約とレート制限があります。このデモで本番環境を無制限に利用できると想定しないでください。API キーやその他の認証情報をコミットしないでください。公開されている読み取り専用 MCP ツールにはキーは不要です。