loan-schedule

mcp-amortization

公式 MCP Registry に掲載されています（io.github.theluckystrike/amortization）。 AI アシスタント向けのローンおよびリースのスケジュールです。信用契約の条件、金額、ベーシスポイントで表した年名目金利、利息の複利計算頻度、支払期日の頻度、期間数、計算方法、手数料、バルーン支払いを入力すると、支払額、実効年利率、および各期間のスケジュール（期首残高、支払額、利息、元金、期末残高）を計算します。早期精算にかかる費用と節約額を回答し、現金出納帳で使われているものと同じ勘定科目名で、支払いの複式仕訳を返します。すべて整数の最小通貨単位で処理され、期末残高は必ずバルーン支払い額またはゼロに正確に到達します。データが外部に送信されることはありません。台帳はお使いのマシン上のファイルです。

@theluckystrike/mcp-amortization の npm 公開は保留中のため、現時点では npx -y @theluckystrike/mcp-amortization を実行すると 404 が返ります。それまでは、.mcpb ワンクリックバンドル、またはクローンしてビルドする方法をご利用ください。

インストール

Claude Desktop、macOS の ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の %APPDATA%\Claude\claude_desktop_config.json：

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

claude mcp add amortization -- npx -y @theluckystrike/mcp-amortization

Cursor、~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）。Claude Desktop と同じエントリです。

ツール

ツール	説明
loan_create	条件に基づいてローンまたはリースを記録します。LOAN-YYYY-NNNN、定額の支払額、実効年利率、支払利息の合計を返します
loan_schedule	各期間の期首残高、支払額、利息、元金、期末残高、および支払利息の合計を含むスケジュールです
loan_repay_early	ある期間に精算または繰り上げ返済した場合の費用を計算します。未払い残高、違約金、再計算後の残りのスケジュール、および違約金を差し引く前後の利息節約額を返します
loan_journal	期間または月ごとの複式仕訳です。利息費用とローン負債を借方、現金を貸方に記帳し、expense_add ですぐ使えるペイロードも返します
loan_list	任意の日付時点の未払い残高と次回支払日を含む台帳です
loan_delete	契約を1件削除し、その枠を空けます。仕訳がすでに作成されている場合は、対象の仕訳名を示して削除を拒否します
loans_report	通貨ごとの未払い額、次回支払期日、および暦年に発生した利息を示します
license_status、license_activate	ご利用のプランを確認し、Pro キーを有効化します

Free と Pro の比較

	Free	Pro
台帳に登録できるローン	3	無制限
スケジュール	無制限	無制限
契約の削除（loan_delete）	はい	はい
繰り上げ返済（loan_repay_early）	-	はい
仕訳（loan_journal）	-	はい
レポート（loans_report）	-	はい

loan_delete は意図的に無料にしています。上限は登録済み契約の数です。同じリースを2回記録すると、キーを使わなければ戻せないまま3枠のうち2枠を占めることになってしまいます。そのため、重複した契約は loan_create が書き込み前に拒否し、一致したレコード名を示します。また、台帳に登録済みの契約は loan_delete で削除できます。ただし、その契約から仕訳が作成済みの場合は、すでに誰かの帳簿に記帳されているため、対象名を示して削除を拒否します。

スケジュールの利用回数は制限されません。支払額と利息はこのサーバーが答えるために存在する質問であり、その答えを隠す無料プランではデモにすぎません。利用上限は、作業単位である登録済み契約の数に設けています。

Pro の購入先：https://mcp.zovo.one/buy/amortization。このサーバー単体は一度限りの支払いで $19、バンドルは $39 です。

数字が示す知見

四半期あたりの金利を名目年率の4分の1として提示すると、貸し手に有利な形で利息の1.0％分が上乗せされます。 名目年率12％、月次複利で、四半期ごとに4回返済するEUR 10,000のローンを考えてみましょう。1四半期あたりの金利は、0.12/4 = 3.0000％ではなく、等価金利の(1 + 0.12/12)^3 - 1 = 3.0301％です。この3ベーシスポイントの差により、返済額はEUR 2,690.27ではなくEUR 2,692.21となり、利息総額はEUR 761.08ではなくEUR 768.84になります。1万ユーロを1年間借りる場合、利息総額の1.0％にあたるEUR 7.76多く支払うことになります。 2つの金利は見積もりでは同じように見えても、返済スケジュールでは差が出ます。そのため、このサーバーではすべての等価金利を複利の計算周期に照らして算出し、使用した期間金利を小数点以下6桁まで表示します。

実効年率を名目年率と並べてすべてのローンで表示するのも、同じ計算が理由です。月次複利の名目年率12％は実効年率12.68％であり、その0.68％分は、表面上の金利には含まれていない価格の一部です。

プライバシー

すべてのデータはローカルの${XDG_DATA_HOME:-~/.local/share}/mcp-servers/amortization/に保存されます。ファイルはloans.jsonとcounter.jsonの2つです。このサーバーは、どのツールからもネットワーク呼び出しを一切行いません。返済スケジュールは保存されません。呼び出し時に指定された条件から各行を算出するためです。スケジュールを保存すると、金利と期間ですでに決まる数値のコピーがもう1つできてしまい、金利が編集された後にそのコピーが正しいと信じられることになるからです。

theluckystrike によって作成されました。https://github.com/theluckystrike

これらのドキュメントを MCP サーバーとして使用する

任意の MCP クライアント（Claude、Cursor、Windsurf、VS Code）から、インストール不要でGitMCP経由でこのリポジトリのドキュメントを直接読み込めます。

• ドキュメントの MCP URL：https://gitmcp.io/theluckystrike/mcp-amortization