horas-mcp

Локальный MCP-сервер для учёта времени по карточке/подзадаче Jira — таймер, паузы, исправления, отчёты и контроль сессий, ожидающих списания. 100% локально (JSON-файл), без зависимости от Jira API. Работает на Node 18+ и может распространяться как один файл.

Сценарий использования (в диалоге с агентом)

Официальное списание времени вы делаете в Jira вручную — в отчёте уже есть округлённое значение в формате worklog (2h 30m) и заметка сессии, которую можно использовать как комментарий.

Сборка

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

Установить на машину компании (GitHub Copilot / VS Code)

Скопируйте только dist/horas.cjs на машину (например: C:\Users\voce\horas\horas.cjs) и зарегистрируйте в VS Code — Ctrl+Shift+P → "MCP: Open User Configuration" (или .vscode/mcp.json из рабочего пространства):

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

Без npm install, без сборки — только Node 18+ и файл. Инструменты появляются в Copilot Chat в режиме agent.

Альтернатива с SQLite: возьмите node-22/dist/horas-sqlite.cjs (тоже единый файл, требуется Node 22.13+; данные в ~/.horas/horas.db). Выберите один из двух вариантов — данные между ними не используются совместно.

Установка в Claude Code

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

Настройка (переменные окружения)

Доступные инструменты

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