mileage-logbook

mcp-mileage-log

公式 MCP Registry（io.github.theluckystrike/mileage-log）に登録されています。 フリーランサーが確定申告の時期に必要とする走行距離の記録を、4月に記憶を頼りに再構成するのではなく、運転したその場で記録する mcp mileage トラッカーです。日付、出発地と目的地、マイルまたは km 単位の距離、目的、カテゴリ（業務、医療、引っ越し、慈善、個人）を入力して各移動を記録し、適用されるレートを管轄区域とカテゴリごとに適用開始日付きの系列として設定できます。集計では、移動した日に適用されていたレートで各移動の料金を、カテゴリと通貨ごとに算出します。記録が整ったら、1 回の呼び出しで CSV にエクスポートして会計士に渡せます。すべてこのマシン上に保存され、アカウントもネットワークへの呼び出しも不要です。

theluckystrike によって開発されました。

@theluckystrike/mcp-mileage-log の npm 公開は保留中のため、現在 npx -y @theluckystrike/mcp-mileage-log は 404 を返します。それまでは、クローンしてビルドする方法が利用できます。

インストール

Claude Desktop

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

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

Claude Code

claude mcp add mileage-log -- npx -y @theluckystrike/mcp-mileage-log

Cursor

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

ツール

ツール	機能
trip_add	日付、出発地、目的地、マイルまたは km 単位の距離、目的、カテゴリを指定して移動を 1 件記録します。TR-YYYY-NNNN を返します
trip_list	各移動で適用されるレートと金額を含め、移動を古い順に一覧表示します。日付範囲とカテゴリで絞り込めます
trip_remove	誤って登録した項目を、正確な ID を指定して削除します。ID は再発行されません
rate_set	指定した管轄区域とカテゴリについて、指定日以降に適用されるマイルまたは km あたりの価値を設定します。全体に適用される単一の数値ではなく、系列として設定します
rate_list	保存されているすべてのレートを、管轄区域とカテゴリごとにまとめ、適用開始日の順に表示します
mileage_summary	指定した日付範囲（デフォルトは当年）について、カテゴリ別の距離、各移動に適用されたレート、控除額を通貨ごとに表示します
mileage_export	会計士向けに記録を CSV で出力します。日付、出発地、目的地、距離、カテゴリ、レート、金額が含まれます。Pro
license_status / license_activate	Free または Pro の状態と、ライセンスキーを確認します

レートは系列として設定し、サーバーには初期設定されていません

税務当局は通常毎年、走行距離のレートを変更するため、このサーバーに全体共通のレートは設定されていません。rate_set では管轄区域、カテゴリ、単位、適用開始日を指定してレートを追加し、各移動にはその日に適用されていたレートが適用されます。**このサーバーにはレートが初期設定されていません。また、以下の例はあくまで例であり、現在の法律を示すものではありません。**申告前に、ご自身に適用される数値を確認してください。

レート設定の例（参考例のみ）：

rate_set jurisdiction:"US federal (EXAMPLE)" category:business    rate:0.70  unit:miles currency:USD effective_from:2026-01-01
rate_set jurisdiction:"US federal (EXAMPLE)" category:business    rate:0.655 unit:miles currency:USD effective_from:2025-01-01
rate_set jurisdiction:"US federal (EXAMPLE)" category:medical     rate:0.21  unit:miles currency:USD effective_from:2026-01-01
rate_set jurisdiction:"US federal (EXAMPLE)" category:charitable  rate:0.14  unit:miles currency:USD effective_from:2026-01-01

これにより、2025 年の移動には 0.655、2026 年の移動には 0.70 が自動的に適用されます。移動距離が km 単位なのにレートがマイルあたり（またはその逆）で設定されている場合は、料金計算の前に正確な換算係数（1 mile = 1.609344 km）を使って距離を換算します。

Free と Pro の比較

	Free	Pro
1 暦月あたりの移動件数	20	無制限
移動の一覧と走行距離の集計	利用可能	利用可能
管轄区域とカテゴリごとのレート	1 件（上書きは Free のまま）	系列を無制限に設定
会計士向け CSV エクスポート	利用不可	利用可能

月間上限は移動日が属する月に基づいて数えるため、確定申告の時期に前年の記録を再構成しても、今月の利用枠は消費されません。記録そのものに利用制限はありません。読み取り、一覧表示、集計は今後もずっと無料です。

Pro の購入先：https://mcp.zovo.one/buy/mileage-log。このサーバー単体は 1 回限りの $19、バンドルは $39 です。

金額と丸め

トリップの控除額は、距離に適用レートを掛け、トリップごとに四捨五入（0.5 は切り上げ）してセント単位にします。すべての合計は、こうして丸めたトリップごとの金額を合算します。合計が明細の合計と食い違うことはなく、CSV エクスポートとサマリーは明細単位で一致します。計算は整数のみで行います（距離は単位の 1000 分の 1、レートは通貨単位の 1000 分の 1 で保持するため）。したがって、1 マイルあたり 0.70 のレートで 12.5 マイル走った場合、金額は正確に 875 セントとなり、874.99999 にはなりません。マイルと km は分けて保持し、決して合算しません。金額も通貨ごとに保持し、混在させません。トリップの単位とレートの単位が異なる場合は、まず距離を換算し（1 マイル = 1.609344 km で正確に換算）、レートの単位の 1000 分の 1 に四捨五入してから金額を計算します。

プライバシー

すべてのデータは ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/mileage-log/ にローカル保存されます。ファイルは 3 つです。trips.json、rates.json、counter.json。データが外部に送信されることはなく、アカウントも API キーも必要ありません。このサーバーではネットワーク通信も一切行いません。ライセンスキーはオフラインで検証されます。このサーバーが計算する内容は税務アドバイスではありません。入力するレートはご自身で確認してください。

theluckystrike が開発しました。https://github.com/theluckystrike

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

任意の MCP クライアント（Claude、Cursor、Windsurf、VS Code）から、インストールせずに GitMCP 経由でこのリポジトリのドキュメントを直接参照できます。

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