Maintenance Log MCP

Histórico de serviço e manutenção para equipamentos e veículos: registre visitas, custos, próximas datas de vencimento e exporte registros.

GitHubExperimente este MCPPatrocinado

Documentação

mcp-maintenance-log

Servidor MCP para um registro e cronograma de manutenção de equipamentos: entradas de serviço, custos e o que está vencido ou atrasado. Registro de manutenção de equipamentos: ativos, entradas de serviço com custos e um relatório de vencimentos calculado a partir das datas armazenadas.

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/maintenance-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/maintenance-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/maintenance-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 maintenance-log.mcpb do último lançamento e clique duas vezes nele.

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

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

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

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

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

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

No Registro MCP oficial (io.github.theluckystrike/maintenance-log). Um registro de manutenção MCP para a oficina, os flats de aluguel, a frota de vans ou o estúdio: um registro local de cada equipamento que você cuida e do trabalho já realizado nele. Adicione cada ativo uma vez — nome, serial ou etiqueta de ativo, onde está — e registre cada serviço ou reparo conforme acontece: a data, o que foi feito, o custo em centavos, quem fez e quando o próximo serviço vence, seja como data ou como intervalo em dias. Pergunte o que está vencido e o relatório responde o que está atrasado e o que vem nos próximos N dias, calculado a partir das datas armazenadas no momento da pergunta, para nunca ficar desatualizado. O histórico por ativo mantém o registro cronológico com o gasto total, e a exportação entrega o registro como CSV para uma planilha ou um resumo em Markdown por ativo. 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-maintenance-log está pendente, então npx -y @theluckystrike/mcp-maintenance-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": {
    "maintenance-log": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-maintenance-log"]
    }
  }
}

Claude Code

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

Cursor

~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto), mesma entrada do Claude Desktop.

Ferramentas

ferramenta	o que faz
`asset_add`	Adiciona um ativo: nome, serial ou etiqueta de ativo, localização, notas, moeda. Retorna `AST-YYYY-NNNN`. Uma etiqueta duplicada é recusada
`maintenance_log`	Registra trabalho em um ativo: o dia, o que foi feito, custo em centavos, técnico e a próxima data de vencimento — como `next_due` ou como `interval_days`, nunca ambos
`maintenance_due`	O relatório de vencimentos: o que está atrasado e por quantos dias, o que vence dentro de N dias (padrão 30), o que está agendado para depois, o que não tem cronograma. Pro
`asset_history`	Um ativo completo: cada entrada em ordem cronológica, gasto total em centavos inteiros, gasto por técnico, o cronograma atual
`maintenance_export`	Entradas em um intervalo de datas como CSV (gratuito) ou um resumo em Markdown por ativo (Pro)
`asset_remove`	Remove um ativo. Um que tenha registro é recusado a menos que `confirm: true`, nomeando o que seria perdido. O número AST nunca é reemitido
`license_status` / `license_activate`	Gratuito ou Pro, e a chave

Gratuito vs Pro

	Gratuito	Pro
Ativos no registro	3	Ilimitado
Registrar trabalho, custo e técnico	Sim	Sim
Histórico por ativo e gasto total	Sim	Sim
Exportação CSV de um intervalo de datas	Sim	Sim
Relatório de vencimentos: atrasados e vencendo em N dias	--	Sim
Resumo em Markdown por ativo	--	Sim

O registro nunca é medido. Três ativos com registro completo e exportação CSV é um registro de trabalho real para uma oficina de uma máquina, e nada do que você registrou é retido. O que o Pro libera é quantos ativos estão no registro, e adiciona o relatório de vencimentos e os resumos em Markdown.

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

Datas e dinheiro

Cada data é armazenada como ISO 8601 (YYYY-MM-DD). Se um serviço está atrasado é calculado a partir da data de hoje no momento da chamada, nunca armazenado, então o registro não pode ficar desatualizado. Um intervalo é convertido em data uma vez, quando o trabalho é registrado: a data do trabalho mais o intervalo, em dias inteiros, em UTC para que a resposta não dependa do fuso horário do servidor. Cada custo é um número inteiro de centavos na moeda do próprio ativo (1200 é 12,00), armazenado na entrada; um gasto total é a soma das entradas armazenadas, então nunca pode divergir das linhas que o compõem.

Privacidade

Todos os dados permanecem locais, em ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/maintenance-log/. Dois arquivos: assets.json, counter.json. Nada é enviado a lugar algum, não há conta, nenhuma chave de API e nenhuma chamada de rede neste servidor. As chaves de licença são verificadas offline.

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 documentos: https://gitmcp.io/theluckystrike/mcp-maintenance-log