Job Card MCP

Tarjetas de trabajo para taller y servicio de campo: abrir, registrar mano de obra y piezas, cerrar con totales, exportar.

GitHubPrueba este MCPPatrocinado

Documentación

mcp-job-card

Servidor MCP para tarjetas de trabajo en oficios y servicio de campo: horas y materiales por trabajo. Una tarjeta por trabajo: horas y materiales registrados contra ella, una máquina de estados desde abierta hasta facturada, y la tarjeta impresa para la firma del cliente.

Funciona con Claude Desktop, Claude Code, Cursor y cualquier cliente del Protocolo de Contexto de Modelos. Se ejecuta en tu propia máquina, o alojado sin instalación.

Página del producto: https://mcp.zovo.one/s/job-card — 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 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 igual. Luego apunta un cliente MCP a https://mcp.zovo.one/mcp/job-card 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/job-card/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 job-card.mcpb desde el último lanzamiento y haz doble clic en él.

Desde el código fuente. El espejo es autocontenido: 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-job-card.git
cd mcp-job-card
npm install && npm run build

Luego apunta tu cliente al punto de entrada compilado:

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

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

job-card demo

Espejo de solo lectura de mcp-servers/servers/job-card. Ver MIRROR.md.

En el Registro MCP oficial (io.github.theluckystrike/job-card). Una tarjeta por trabajo, como la tarjeta de papel en el tablero. Abre una tarjeta para el cliente y el sitio, registra las horas que cada trabajador dedica a su tarifa y los materiales que entran en el trabajo, y la tarjeta mantiene los totales acumulados: mano de obra, materiales y el total general, siempre en centavos enteros. Avanza la tarjeta a medida que el trabajo avanza: abierta, en progreso, terminada, facturada, archivada, y cuando el cliente quiera verla, imprime la tarjeta con su línea de firma para la aprobación. Un resumen diario o semanal responde a dónde fueron las horas del equipo y cuánto vale el trabajo, por moneda. Todo permanece en esta máquina; no hay cuenta ni llamada de red.

Creado por theluckystrike.

La publicación en npm para @theluckystrike/mcp-job-card está pendiente, por lo que npx -y @theluckystrike/mcp-job-card 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": {
    "job-card": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-job-card"]
    }
  }
}

Claude Code

claude mcp add job-card -- npx -y @theluckystrike/mcp-job-card

Cursor

~/.cursor/mcp.json (global) o .cursor/mcp.json (proyecto), misma entrada que Claude Desktop.

Herramientas

herramienta	qué hace
`job_card_create`	Abre una tarjeta de trabajo: cliente, sitio, en qué consiste el trabajo, moneda, fecha programada. Devuelve `JC-YYYY-NNNN`
`job_card_log_labor`	Registra horas en una tarjeta de trabajo: quién hizo el trabajo, el día, las horas, la tarifa por hora en centavos, qué se hizo
`job_card_log_material`	Registra materiales usados en una tarjeta de trabajo: el artículo, la cantidad, el costo unitario en centavos
`job_card_update_status`	Mueve la tarjeta exactamente un paso — abierta, en_progreso, terminada, facturada, archivada — sellando fecha y nota en su historial
`job_card_list`	Lista tarjetas de la más reciente a la más antigua con horas y totales; filtra por estado y cliente; totales mantenidos por moneda
`job_card_get`	Lee una tarjeta completa: cada entrada, horas por trabajador y los totales acumulados en centavos enteros
`job_card_print`	Renderiza la tarjeta lista para imprimir, con una línea de firma para la aprobación del cliente. Markdown o HTML autocontenido
`job_card_delete`	Elimina una tarjeta ingresada por error. Una que contenga mano de obra o materiales es rechazada; archívala en su lugar
`job_card_summary`	Un día o una semana: tarjetas tocadas, horas por trabajador, valor de mano de obra y materiales por moneda. Una semana va de lunes a domingo
`license_status` / `license_activate`	Gratis o Pro, y la clave

Gratis vs Pro

	Gratis	Pro
Tarjetas de trabajo activas	10	Ilimitadas
Entradas de mano de obra y materiales por tarjeta	Ilimitadas	Ilimitadas
Totales acumulados, lista y obtención	Sí	Sí
Tarjeta imprimible, markdown y HTML	Sí	Sí
Resumen diario y semanal	Sí	Sí

El registro nunca se mide. Diez tarjetas activas son un tablero de trabajo real para un equipo pequeño, y una tarjeta deja de contar en el momento en que se archiva, por lo que el registro, los totales, la impresión y los resúmenes siguen siendo gratuitos para siempre. Lo que Pro eleva es cuántos trabajos están en el tablero a la vez.

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

Dinero y redondeo

Cada monto es un número entero de centavos (un centavo es 1/100 de la unidad monetaria). Una línea de mano de obra es horas por la tarifa por hora; una línea de materiales es cantidad por el costo unitario; cada valor de línea se redondea hacia arriba al centavo más cercano una vez, en el momento en que se registra, y se almacena en la entrada. Los totales son las sumas de esos valores de línea almacenados, por lo que un total nunca puede desviarse de sus líneas. Las horas se llevan como centésimas enteras y las cantidades como milésimas enteras, por lo que 2.5 horas a 4999 centavos por hora son 12498 centavos, nunca 12497.499999. Las monedas nunca se suman entre sí: este servidor no contiene tipo de cambio.

Privacidad

Todos los datos permanecen locales, en ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/job-card/. Dos archivos: cards.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 en absoluto. 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 a través de GitMCP — sin instalación:

URL de documentos MCP: https://gitmcp.io/theluckystrike/mcp-job-card