mileage-logbook

mcp-mileage-log

已收录于 官方 MCP 注册表（io.github.theluckystrike/mileage-log）。 一款 mcp mileage 追踪工具，可记录自由职业者在报税时所需的里程日志：在行程发生时记录，而不是等到 4 月再凭记忆重建。记录每趟行程的日期、起点和终点、以英里或 km 为单位的距离、用途和类别（商务、医疗、搬家、慈善、个人）；按司法管辖区和类别设置适用于你的费率，并按生效日期排列；摘要会根据行程发生当天的有效费率，按类别和货币为每趟行程计算费用。日志记录无误后，只需调用一次即可导出 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 为单位的距离、用途、类别。返回 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 英里 = 1.609344 km）进行换算。

Free 与 Pro

	Free	Pro
每个日历月的行程数	20	不限
行程列表和里程摘要	是	是
每个司法管辖区和类别的费率	1 个（覆盖原费率仍可免费使用）	不限，按时间排列
提供给会计师的 CSV 导出	否	是

每月上限按行程日期所在的月份计算，因此报税时补记去年的行程不会占用本月额度。日志本身永远不会计入限额：读取、列出和汇总始终免费。

获取 Pro：https://mcp.zovo.one/buy/mileage-log，单独购买此服务一次性收费 $19，或购买套装，费用为 $39。

金额与舍入

一次行程的可抵扣金额等于行程距离乘以有效费率，并按四舍五入（恰好为 5 时进位）至分的方式逐次舍入。所有合计金额均为逐次舍入后的行程金额之和：合计金额始终与组成它的各项金额一致，CSV 导出也会与汇总逐项核对。计算仅使用整数（距离以千分之一单位计，费率以千分之一货币单位计），因此，12.5 英里按每英里 0.70 计算，结果正好是 875 分，绝不会是 874.99999。英里和公里分别保留，绝不相加；金额按币种分别保留，绝不混用。如果行程的距离单位与费率单位不同，则先换算距离（1 英里 = 1.609344 公里，精确值），并按费率单位的千分之一进行四舍五入（恰好为 5 时进位），然后再计算金额。

隐私

所有数据都保存在本地的 ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/mileage-log/ 中，共有三个文件：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