Mileage Log MCP

Captura de milhagem empresarial: viagens, tarifas por jurisdição, totais mensais e anuais, exportação em CSV para sua declaração de imposto.

GitHubExperimente este MCPPatrocinado

Documentação

mcp-mileage-log

Servidor MCP para um registro de quilometragem de direção dedutível: viagens, tarifas com data de vigência, resumos e exportação CSV. Registro de quilometragem para direção dedutível: viagens, tarifas com data de vigência, resumos e exportação CSV.

Funciona com Claude Desktop, Claude Code, Cursor e qualquer cliente do Model Context Protocol. Roda na sua própria máquina ou hospedado, sem instalação.

Página do produto: https://mcp.zovo.one/s/mileage-log — o que faz, as ferramentas que expõe e um endpoint de token ao vivo.

Instalação

Hospedado, nada para instalar. Obtenha um token em https://mcp.zovo.one/mcp/connect (a página de conexão) ou https://mcp.zovo.one/mcp/token (o mesmo token como JSON); um token anônimo gratuito é emitido na hora e uma chave Pro funciona da mesma forma. Em seguida, aponte um cliente MCP para https://mcp.zovo.one/mcp/mileage-log via streamable-http e envie o token como Authorization: Bearer <token>.

Se o seu cliente não puder definir cabeçalhos, coloque o token no caminho: https://mcp.zovo.one/mcp/mileage-log/t/<token>. Ambas as formas funcionam. A URL simples sem token responde 401 em tools/call, então o token não é opcional.

Claude Desktop, um clique. Baixe mileage-log.mcpb do último lançamento e clique duas vezes nele.

A partir do código-fonte. O espelho é autossuficiente: toda dependência @theluckystrike/* é incluída, então um clone novo compila sem configuração extra.

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

Em seguida, aponte seu cliente para o ponto de entrada compilado:

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

@theluckystrike/mcp-mileage-log ainda não está publicado no npm, então um comando npx -y @theluckystrike/mcp-mileage-log falhará. Os três caminhos acima são os que funcionam e cada um é testado pelo CI.

Espelho somente leitura de mcp-servers/servers/mileage-log. Veja MIRROR.md.

No Registro Oficial de MCP (io.github.theluckystrike/mileage-log). Um rastreador mcp mileage que mantém o registro de quilometragem que freelancers precisam na época do imposto, no momento em que a viagem acontece, em vez de reconstruído de memória em abril. Registre cada viagem com a data, de e para, a distância em milhas ou km, o propósito e a categoria (negócios, médico, mudança, filantrópico, pessoal); defina as tarifas que se aplicam a você como uma série com data de vigência por jurisdição e categoria; e o resumo precifica cada viagem pela tarifa em vigor no dia em que foi feita, por categoria e por moeda. Quando o registro está correto, uma chamada o exporta como CSV para entregar ao seu contador. Tudo permanece nesta máquina; não há conta nem chamada de rede.

Construído por theluckystrike.

A publicação no npm para @theluckystrike/mcp-mileage-log está pendente, então npx -y @theluckystrike/mcp-mileage-log retorna 404 hoje. Até lá, clonar+compilar é o caminho que funciona.

Instalação

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) ou .cursor/mcp.json (projeto), mesma entrada do Claude Desktop.

Ferramentas

ferramenta	o que faz
`trip_add`	Registra uma viagem: data, de, para, distância em milhas ou km, propósito, categoria. Retorna `TR-YYYY-NNNN`
`trip_list`	Lista viagens da mais antiga para a mais recente, com a tarifa e o valor que cada uma gera; filtra por intervalo de datas e categoria
`trip_remove`	Remove uma viagem pelo id exato, para entradas feitas por engano. O id não é reemitido
`rate_set`	Define o valor de uma milha ou km para uma categoria em uma jurisdição a partir de uma data. Uma série, não um número global
`rate_list`	Todas as tarifas registradas, agrupadas por jurisdição e categoria com datas de vigência em ordem
`mileage_summary`	Um intervalo de datas (padrão: ano atual): distância por categoria, a tarifa que cada viagem gerou e o valor dedutível, por moeda
`mileage_export`	O registro como CSV para um contador: data, de, para, distância, categoria, tarifa, valor. Pro
`license_status` / `license_activate`	Gratuito ou Pro, e a chave

Tarifas são uma série, e nenhuma acompanha o servidor

As autoridades fiscais alteram suas tarifas de quilometragem, geralmente todo ano, então este servidor nunca mantém uma tarifa global: rate_set adiciona uma tarifa para uma jurisdição, uma categoria e uma unidade a partir de uma data de vigência, e cada viagem ganha a tarifa em vigor no seu próprio dia. Nenhuma tarifa acompanha este servidor, e o exemplo abaixo é um EXEMPLO, não uma declaração da lei atual. Verifique os valores que se aplicam a você antes de declarar.

Um exemplo de conjunto de tarifas (apenas 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

Uma viagem de 2025 então é precificada a 0,655 e uma viagem de 2026 a 0,70, automaticamente. Se suas viagens estão em km e sua tarifa é por milha (ou o contrário), a distância é convertida com o fator exato (1 milha = 1,609344 km) antes da precificação.

Gratuito vs Pro

	Gratuito	Pro
Viagens por mês civil	20	Ilimitado
Lista de viagens e resumo de quilometragem	Sim	Sim
Tarifas por jurisdição e categoria	1 (sobrescrever continua gratuito)	Série ilimitada
Exportação CSV para o contador	Não	Sim

O limite mensal é contado pelo mês da data da viagem, então reconstruir o registro do ano passado na época do imposto não consome a cota deste mês. O registro em si nunca é medido: ler, listar e resumir permanecem gratuitos para sempre.

Obtenha Pro: https://mcp.zovo.one/buy/mileage-log, $19 pagamento único para este servidor, ou $39 para o pacote.

Dinheiro e arredondamento

O valor dedutível de uma viagem é a distância vezes a tarifa vigente, arredondado para cima no meio, ao centavo por viagem, e cada total é a soma desses valores arredondados por viagem: um total nunca pode divergir das linhas que o compõem, e a exportação CSV reconcilia linha por linha com o resumo. A aritmética é somente com inteiros (distâncias em milésimos de unidade, tarifas em milésimos de unidade monetária), então 12,5 milhas a 0,70 por milha é exatamente 875 centavos, nunca 874,99999. Milhas e km são mantidos separados e nunca somados; valores são mantidos por moeda e nunca misturados. Quando a unidade de uma viagem difere da tarifa, a distância é convertida primeiro (1 milha = 1,609344 km exatamente) e arredondada para cima no meio, ao milésimo da unidade da tarifa, e então precificada.

Privacidade

Todos os dados permanecem locais, em ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/mileage-log/. Três arquivos: trips.json, rates.json, counter.json. Nada é enviado a lugar algum, não há conta, nenhuma chave de API e nenhuma chamada de rede neste servidor. Chaves de licença são verificadas offline. Nada que este servidor calcula é aconselhamento fiscal; as tarifas que você insere são seus próprios valores a verificar.

Construído por theluckystrike. https://github.com/theluckystrike

Use estes documentos como um servidor MCP

Qualquer cliente MCP (Claude, Cursor, Windsurf, VS Code) pode ler a documentação deste repositório diretamente via GitMCP — sem instalação:

URL do MCP de Documentação: https://gitmcp.io/theluckystrike/mcp-mileage-log