Skip to main content
Glama

horas-mcp

Lokaler MCP-Server zur Zeiterfassung pro Jira-Card/Unteraufgabe – Timer, Pausen, Korrekturen, Berichte und Kontrolle offener Zeiterfassungen. 100 % lokal (JSON-Datei), ohne Abhängigkeit von der Jira-API. Läuft unter Node 18+ und kann als einzelne Datei verteilt werden.

Nutzungsablauf (im Gespräch mit dem Assistenten)

Du sagst

Was passiert

„starte SUB-456"

startet den Timer (stoppt den vorherigen automatisch)

„Pause" / „bin zurück"

pausiert und nimmt wieder auf (Mittag, Besprechung)

„fertig" –

beendet die Sitzung und zeigt echte + gerundete Zeit

„ich habe SUB-456 um 9h begonnen"

rückwirkender Start

„ich habe gestern 1h30 an SUB-457 geardie"

manuelle Erfassung

„Bericht für heute / die Woche"

Tabelle nach Card mit offenen Zeitbuchungen

„ich habe SUB-456 gebucht"

markiert (verschwindet aus den offenen Einträgen)

Den offiziellen Zeiterikationseintrag pflegst du manuell in Jira ein – der Bericht zeigt bereits den gerundeten Wert im Worklog-Format (2h 30m) und die Notiz der Sitzung, die du als Kommentar verwenden kannst.

Build

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

Installation auf dem Firmenrechner (GitHub Copilot / VS Code)

Kopiere nur dist/horas.cjs auf den Rechner (z. B. C:\Users\voce\horas\horas.cjs) und registriere sie in VS Code – Ctrl+Shift+P → "MCP: Open User Configuration" (oder .vscode/mcp.json des Arbeitsbereichs):

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

Kein npm install, kein Build – nur Node 18+ und die Datei. Die Tools werden im Copilot Chat im Agentenmodus angezeigt.

SQLite-Alternative: nimm node-22/dist/horas-sqlite.cjs (ebenfalls eine einzelne Datei, benötigt Node 22.13+; Daten in ~/.horas/horas.db). Wähle eine der beiden – die Daten werden nicht zwischen ihnen geteilt.

Installation in Claude Code

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

Konfiguration (Umgebungsvariablen)

Variable

Standard

Beschreibung

HORAS_BLOCO_MIN

15

Rundungsblock in Minuten (0 deaktiviert)

HORAS_ARREDONDAR

oben

Modus: oben, proximo oder baixo

HORAS_SESSAO_MAX_HORAS

12

Längere offene Sitzungen werden als vergessener Timer behandelt

HORAS_DB

~/.horas/horas.json

Pfad der Datendatei (JSON, atomisches Schreiben)

Verfügbare Tools

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors