horas-mcp
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設定(環境変数)
環境変数 | デフォルト | 説明 |
|
| 丸めブロックのサイズ(分)。 |
|
| モード: |
|
| これを超えて開いているセッションは、タイマー忘れとして扱う |
|
| データファイルのパス(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
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.