Maintenance Log MCP

Historial de servicio y mantenimiento de equipos y vehículos: registre visitas, costos, próximos vencimientos y exporte registros.

GitHubPrueba este MCPPatrocinado

Documentación

mcp-maintenance-log

Servidor MCP para un registro y calendario de mantenimiento de equipos: entradas de servicio, costos y qué está pendiente o vencido. Registro de mantenimiento de equipos: activos, entradas de servicio con costos y un informe de vencimientos calculado a partir de las fechas almacenadas.

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

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

Instalación

Alojado, sin nada que instalar. Obtén un token de https://mcp.zovo.one/mcp/connect (la página de conexión) o de 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/maintenance-log mediante 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/maintenance-log/t/<token>. Ambas formas funcionan. La URL sin token responde 401 en tools/call, por lo que el token no es opcional.

Claude Desktop, un clic. Descarga maintenance-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 una clonación nueva se compila sin configuración adicional.

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

Luego apunta tu cliente al punto de entrada compilado:

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

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

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

En el Registro oficial de MCP (io.github.theluckystrike/maintenance-log). Un registro de mantenimiento MCP para el taller, los pisos de alquiler, la flota de furgonetas o el estudio: un registro local de cada pieza de equipo que cuidas y el trabajo que se le ha realizado. Añade cada activo una vez: nombre, número de serie o etiqueta de activo, ubicación, notas; luego registra cada servicio o reparación a medida que ocurre: la fecha, qué se hizo, cuánto costó en céntimos, quién lo hizo y cuándo corresponde el próximo servicio, ya sea como fecha o como intervalo en días. Pregunta qué está pendiente y el informe responde qué está vencido y qué se acerca en los próximos N días, calculado a partir de las fechas almacenadas en el momento de preguntar, por lo que nunca puede quedar desactualizado. El historial por activo mantiene el registro cronológico con su gasto total, y la exportación entrega el registro como CSV para una hoja de cálculo o un resumen en Markdown por activo. Todo permanece en esta máquina; no hay cuenta ni llamada de red.

Creado por theluckystrike.

La publicación en npm para @theluckystrike/mcp-maintenance-log está pendiente, por lo que npx -y @theluckystrike/mcp-maintenance-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": {
    "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) o .cursor/mcp.json (proyecto), misma entrada que Claude Desktop.

Herramientas

herramienta	qué hace
`asset_add`	Añadir un activo: nombre, número de serie o etiqueta de activo, ubicación, notas, moneda. Devuelve `AST-YYYY-NNNN`. Se rechaza una etiqueta duplicada
`maintenance_log`	Registrar trabajo en un activo: el día, qué se hizo, costo en céntimos, técnico y la próxima fecha de vencimiento — como `next_due` o como `interval_days`, nunca ambos
`maintenance_due`	El informe de vencimientos: qué está vencido y por cuántos días, qué vence dentro de N días (por defecto 30), qué está programado para más tarde, qué no tiene programación. Pro
`asset_history`	Un activo completo: cada entrada en orden cronológico, gasto total en céntimos enteros, gasto por técnico, el calendario bajo el que se encuentra actualmente
`maintenance_export`	Entradas en un rango de fechas como CSV (gratis) o un resumen en Markdown por activo (Pro)
`asset_remove`	Eliminar un activo. Uno que tenga un registro se rechaza a menos que `confirm: true`, nombrando lo que se perdería. El número AST nunca se reemite
`license_status` / `license_activate`	Gratis o Pro, y la clave

Gratis vs Pro

	Gratis	Pro
Activos en el registro	3	Ilimitados
Registrar trabajo, costo y técnico	Sí	Sí
Historial por activo y gasto total	Sí	Sí
Exportación CSV de un rango de fechas	Sí	Sí
Informe de vencimientos: vencidos y por vencer en N días	--	Sí
Resumen en Markdown por activo	--	Sí

El registro nunca se mide. Tres activos con registro completo y exportación CSV es un registro de trabajo real para un taller de una sola máquina, y nada de lo que hayas registrado se retiene jamás. Lo que Pro eleva es cuántos activos hay en el registro, y añade el informe de vencimientos y los resúmenes en Markdown.

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

Fechas y dinero

Cada fecha se almacena como ISO 8601 (YYYY-MM-DD). Si un servicio está vencido se calcula a partir de la fecha de hoy en el momento de la llamada, nunca se almacena, por lo que el registro no puede quedar desactualizado. Un intervalo se convierte en una fecha una vez, cuando se registra el trabajo: la fecha del trabajo más el intervalo, en días completos, en UTC para que la respuesta no dependa de la zona horaria del servidor. Cada costo es un número entero de céntimos en la moneda del propio activo (1200 es 12.00), almacenado en la entrada; un gasto total es la suma de las entradas almacenadas, por lo que nunca puede desviarse de las líneas que lo componen.

Privacidad

Todos los datos permanecen locales, en ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/maintenance-log/. Dos archivos: assets.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.

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

Usa estos documentos como servidor MCP

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

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