horas-mcp
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.cjsKonfiguration (Umgebungsvariablen)
Variable | Standard | Beschreibung |
|
| Rundungsblock in Minuten ( |
|
| Modus: |
|
| Längere offene Sitzungen werden als vergessener Timer behandelt |
|
| 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
Log time on Trello cards and read time reports. Free during early access.
Track billable time from your AI chat: timers, entries, reports, CSV export. All data stays local.
Track billable time from your AI chat: timers, entries, reports, CSV export. All data stays local.
Personal time tracker: start timers, log time and summarize your hours by activity.