Mileage Log MCP

Captura de kilometraje empresarial: viajes, tarifas por jurisdicción, totales mensuales y anuales, exportación CSV para tu declaración de impuestos.

GitHubPrueba este MCPPatrocinado

Documentación

mcp-mileage-log

Servidor MCP para un registro de kilometraje de conducción deducible: viajes, tarifas con fecha de vigencia, resúmenes y exportación CSV. Registro de kilometraje para conducción deducible: viajes, tarifas con fecha de vigencia, resúmenes y exportación CSV.

Funciona con Claude Desktop, Claude Code, Cursor y cualquier cliente del Model Context Protocol. Se ejecuta en tu propia máquina, o alojado sin instalación.

Página del producto: https://mcp.zovo.one/s/mileage-log — qué hace, las herramientas que expone y un endpoint de token en vivo.

Instalación

Alojado, nada que instalar. Obtén un token de https://mcp.zovo.one/mcp/connect (la página de conexión) o https://mcp.zovo.one/mcp/token (el mismo token como JSON); se emite uno anónimo gratuito al instante y una clave Pro funciona de la misma manera. Luego apunta un cliente MCP a https://mcp.zovo.one/mcp/mileage-log a través de streamable-http y envía el token como Authorization: Bearer <token>.

Si tu cliente no puede configurar encabezados, coloca el token en la ruta en su lugar: https://mcp.zovo.one/mcp/mileage-log/t/<token>. Ambas formas funcionan. La URL desnuda sin token responde 401 en tools/call, por lo que el token no es opcional.

Claude Desktop, un clic. Descarga mileage-log.mcpb desde la última versión y haz doble clic en él.

Desde el código fuente. El espejo es autónomo: cada dependencia de @theluckystrike/* está incluida, por lo que un clon nuevo se compila sin configuración adicional.

git clone https://github.com/theluckystrike/mcp-mileage-log.git
cd mcp-mileage-log
npm install && npm run build

Luego apunta tu cliente al punto de entrada compilado:

{
  "mcpServers": {
    "mileage-log": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-mileage-log/dist/index.js"]
    }
  }
}

@theluckystrike/mcp-mileage-log aún no está publicado en npm, por lo que un comando npx -y @theluckystrike/mcp-mileage-log fallará. Las tres rutas anteriores son las que funcionan y cada una es probada por CI.

Espejo de solo lectura de mcp-servers/servers/mileage-log. Consulta MIRROR.md.

En el Registro oficial de MCP (io.github.theluckystrike/mileage-log). Un rastreador de kilometraje mcp que mantiene el registro de kilometraje que los autónomos necesitan en la temporada de impuestos, en el momento del viaje en lugar de reconstruirlo de memoria en abril. Registra cada viaje con la fecha, de y hacia, la distancia en millas o km, el propósito y la categoría (negocio, médico, mudanza, benéfico, personal); establece las tarifas que te corresponden como una serie con fecha de vigencia por jurisdicción y categoría; y el resumen calcula el precio de cada viaje a la tarifa vigente el día en que se condujo, por categoría y por moneda. Cuando el registro está correcto, una llamada lo exporta como CSV para entregarlo a tu contador. Todo permanece en esta máquina; no hay cuenta ni llamada de red.

Creado por theluckystrike.

La publicación en npm para @theluckystrike/mcp-mileage-log está pendiente, por lo que npx -y @theluckystrike/mcp-mileage-log devuelve 404 hoy. Hasta entonces, clonar y compilar es la ruta que funciona.

Instalación

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 (global) o .cursor/mcp.json (proyecto), misma entrada que Claude Desktop.

Herramientas

herramienta	qué hace
`trip_add`	Registra un viaje: fecha, de, hacia, distancia en millas o km, propósito, categoría. Devuelve `TR-YYYY-NNNN`
`trip_list`	Lista los viajes del más antiguo al más reciente, con la tarifa y el monto que genera cada uno; filtra por rango de fechas y categoría
`trip_remove`	Elimina un viaje por su id exacto, para entradas hechas por error. El id no se reemite
`rate_set`	Establece cuánto vale una milla o km para una categoría en una jurisdicción a partir de una fecha. Una serie, no un número global
`rate_list`	Cada tarifa registrada, agrupada por jurisdicción y categoría con fechas de vigencia en orden
`mileage_summary`	Un rango de fechas (por defecto el año actual): distancia por categoría, la tarifa que ganó cada viaje y el monto deducible, por moneda
`mileage_export`	El registro como CSV para un contador: fecha, de, hacia, distancia, categoría, tarifa, monto. Pro
`license_status` / `license_activate`	Gratis o Pro, y la clave

Las tarifas son una serie, y ninguna viene con el servidor

Las autoridades fiscales cambian sus tarifas de kilometraje, generalmente cada año, por lo que este servidor nunca mantiene una tarifa global: rate_set agrega una tarifa para una jurisdicción, una categoría y una unidad a partir de una fecha de vigencia, y cada viaje gana la tarifa vigente en su propio día. Ninguna tarifa viene con este servidor, y el ejemplo a continuación es un EJEMPLO, no una declaración de la ley vigente. Verifica las cifras que te corresponden antes de presentar tu declaración.

Un conjunto de tarifas de ejemplo (solo ilustrativo):

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

Un viaje de 2025 se calcula entonces a 0.655 y un viaje de 2026 a 0.70, automáticamente. Si tus viajes están en km y tu tarifa es por milla (o al revés), la distancia se convierte con el factor exacto (1 milla = 1.609344 km) antes de calcular el precio.

Gratis vs Pro

	Gratis	Pro
Viajes por mes calendario	20	Ilimitados
Lista de viajes y resumen de kilometraje	Sí	Sí
Tarifas por jurisdicción y categoría	1 (sobrescribir sigue siendo gratis)	Serie ilimitada
Exportación CSV para el contador	No	Sí

El límite mensual se cuenta según el mes de la fecha del viaje, por lo que reconstruir el registro del año pasado en la temporada de impuestos no consume la asignación de este mes. El registro en sí nunca se mide: leer, listar y resumir siguen siendo gratuitos para siempre.

Obtén Pro: https://mcp.zovo.one/buy/mileage-log, $19 de pago único para este servidor, o $39 por el paquete.

Dinero y redondeo

El monto deducible de un viaje es su distancia multiplicada por la tarifa vigente, redondeado hacia arriba al centavo por viaje, y cada total es la suma de esos montos redondeados por viaje: un total nunca puede desviarse de las líneas que lo componen, y la exportación CSV concilia línea por línea con el resumen. La aritmética es solo de enteros (distancias como milésimas de una unidad, tarifas como milésimas de una unidad monetaria), por lo que 12.5 millas a 0.70 por milla son exactamente 875 centavos, nunca 874.99999. Las millas y los km se mantienen separados y nunca se suman; los montos se mantienen por moneda y nunca se mezclan. Cuando la unidad de un viaje difiere de la de la tarifa, la distancia se convierte primero (1 milla = 1.609344 km exactamente) y se redondea hacia arriba a la milésima de la unidad de la tarifa, luego se calcula el precio.

Privacidad

Todos los datos permanecen locales, en ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/mileage-log/. Tres archivos: trips.json, rates.json, counter.json. No se envía nada a ningún lugar, no hay cuenta, ni clave API ni llamada de red en este servidor. Las claves de licencia se verifican sin conexión. Nada de lo que este servidor calcula es asesoramiento fiscal; las tarifas que ingresas son tus propias cifras para verificar.

Creado por theluckystrike. https://github.com/theluckystrike

Usa estos documentos como un servidor MCP

Cualquier cliente MCP (Claude, Cursor, Windsurf, VS Code) puede leer la documentación de este repositorio directamente a través de GitMCP — sin instalación:

URL de documentos MCP: https://gitmcp.io/theluckystrike/mcp-mileage-log