Skip to main content
Glama
Sign In
deenesjakoptruzh
horas-mcp

horas-mcp

by gabrielgehren
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

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)

Tú dices

Qué ocurre

"empieza la SUB-456"

inicia el cronómetro (detiene la anterior automáticamente)

"pausa" / "volví"

pausa/reanuda (almuerzo, reunión)

"terminé"

cierra la sesión y muestra el tiempo real + arredondeado

"empecé la SUB-456 a las 9h"

inicio retroactivo

"trabajé 1h30 ayer en la SUB-457"

registro manual

"informe de hoy / de la semana"

tabla por tarjeta con horas pendientes de registrar

"registré la SUB-456"

la marca como registrada (desaparece de los pendientes)

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)

Variable

Valor por defecto

Descripción

HORAS_BLOCO_MIN

15

Tamaño del bloque de redondeo en minutos (0 lo desactiva)

HORAS_ARREDONDAR

cima

Modo: cima, proximo o baixo

HORAS_SESSAO_MAX_HORAS

12

Una sesión abierta más allá de eso se trata como temporizador olvidado

HORAS_DB

~/.horas/horas.json

Ruta del archivo de datos (JSON, escritura atómica)

Herramientas expuestas

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors