horas-mcp

本地 MCP 服务器，用于按 Jira 卡片/子任务控制工时——计时器、暂停、修正、报表和待登记工时控制。100% 本地（JSON 文件），不依赖 Jira API。运行在 Node 18+，并可作为单个文件分发。

使用流程（与 agent 对话）

正式的工时登记由你在 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 mode 中。

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