horas-mcp

Servidor MCP local para el control de horas por tarjeta/subtarea de Jira — cronómetro, pausas, correcciones, informes y control de horas pendientes de registrar. 100% local (archivo JSON), sin depender de la API de Jira. Funciona en Node 18+ y puede distribuirse como un único archivo.

Flujo de uso (hablando con el agente)

El registro oficial lo haces en Jira manualmente — el informe ya muestra el valor redondeado en el formato del registro de trabajo (2h 30m) y la nota de la sesión para usarla como comentario.

Compilación

npm install
npm run build     # dist/index.js (ESM, para desenvolvimento)
npm run bundle    # dist/horas.cjs — ARQUIVO ÚNICO, autocontido, Node 18+

Instalar en la máquina de la empresa (GitHub Copilot / VS Code)

Copia solo dist/horas.cjs a la máquina (ej.: C:\Users\voce\horas\horas.cjs) y regístralo en VS Code — Ctrl+Shift+P → "MCP: Open User Configuration" (o .vscode/mcp.json del workspace):

{
  "servers": {
    "horas": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/Users/voce/horas/horas.cjs"],
      "env": { "HORAS_BLOCO_MIN": "15", "HORAS_ARREDONDAR": "cima" }
    }
  }
}

Sin npm install, sin compilación — solo Node 18+ y el archivo. Las herramientas aparecen en Copilot Chat en modo agente.

Alternativa con SQLite: usa node-22/dist/horas-sqlite.cjs (también archivo único, requiere Node 22.13; los datos en ~/.horas/horas.db). Elige una de las dos — los datos no se comparten entre ellas.

Instalar en Claude Code

claude mcp add --scope user horas -- node D:/Gabriel/Projetos/horas/dist/horas.cjs

Configuración (variables de entorno)

Herramientas expuestas

iniciar_tarefa · pausar_tarefa · retomar_tarefa · parar_tarefa · status_atual · registrar_manual · editar_sessao · excluir_sessao · relatorio · marcar_apontado