Skip to main content
Glama

horas-mcp

Jira のカード/サブタスクごとの時間管理を行うためのローカル MCP サーバー — タイマー、一時停止、修正、レポート、未入力の工数管理ポイント。100% ローカル(JSON ファイル)で、Jira API には依存しません。Node 18+ で動作し、単一ファイルとして配布できます。

利用フロー(エージェントとの会話)

あなたが言う

実行されること

"SUB-456 を開始"

タイマーを開始(前のタイマーは自動的に停止)

"一時停止" / "再開"

一時停止 / 再開(昼食、会議など)

"完了"

セッションを終了し、実時間と丸め時間を表示

"9時に SUB-456 を開始した"

開始時刻を過去に遡って記録

"昨日 SUB-457 で1時間30分働いた"

手動記録

"今日 / 今週のレポート"

カードごとの表と未入力の工数を表示

"SUB-456 の工数を入力した"

入力済みとしてマーク(未入力の一覧から消える)

正式な工数入力は 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 のエージェント モードに表示されます。

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

設定(環境変数)

環境変数

デフォルト

説明

HORAS_BLOCO_MIN

15

丸めブロックのサイズ(分)。0 で無効

HORAS_ARREDONDAR

cima

モード: cima、proximo、baixo

HORAS_SESSAO_MAX_HORAS

12

これを超えて開いているセッションは、タイマー忘れとして扱う

HORAS_DB

~/.horas/horas.json

データファイルのパス(JSON、アトミック書き込み)

公開ツール

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