horas-mcp

Jira의 카드/하위 작업별로 시간을 관리하는 로컬 MCP 서버 — 타이머, 일시정지, 수정, 보고서, 미등록 작업 시간 관리. 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+

회사 PC에 설치(GitHub Copilot / VS Code)

dist/horas.cjs 하나만 대상 PC(예: 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 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