Harvest 자연어 시간 입력 MCP 서버
자연어를 사용하여 수확 시간 항목을 기록하고 휴가 요청에 대한 특수 처리를 지원하는 MCP 서버입니다. 이 서버는 자연어 입력을 이해하고 휴가 요청과 같은 일반적인 상황을 자동으로 처리하여 시간 추적을 더욱 직관적으로 만들어줍니다.
특징
🗣️ 자연어 시간 항목 구문 분석
🏖️ 특별 휴가 요청 처리(예: "오늘 병가입니다")
⏰ 설정 가능한 근무 시간
🌍 시간대 지원
🎯 자동 프로젝트 및 작업 매칭
📅 스마트 날짜 파싱(오늘, 어제 등)
Related MCP server: Harvest MCP Server
필수 조건
Node.js가 설치됨
수확 계정
Harvest Developer Tools 의 개인 액세스 토큰
계정 ID(토큰과 같은 페이지에 표시됨)
설치
설치
이 저장소를 복제하세요:
지엑스피1
종속성을 설치하고 빌드합니다.
설치 스크립트를 실행합니다.
화면의 지시에 따라 다음을 입력하세요.
Harvest 개인 액세스 토큰( https://id.getharvest.com/developers 에서)
수확 계정 ID
표준 근무 시간(기본값: 7.5)
시간대(기본값: 호주/퍼스)
Claude 데스크톱 앱을 다시 시작하세요
이제 Claude에서 자연어 시간 추적을 사용할 수 있습니다.
최신 정보 받기
최신 버전으로 업데이트하려면:
설치 스크립트는 Claude가 서버의 로컬 빌드를 사용하도록 구성했으므로, 끌어온 모든 업데이트는 다시 빌드한 후 자동으로 사용할 수 있습니다.
용법
서버는 Harvest와 상호 작용하기 위한 여러 도구를 제공합니다.
로그 시간
자연어를 사용하여 시간 항목을 기록합니다. 예:
정기 시간 항목:
휴가 요청(표준 근무 시간을 자동으로 사용):
시간 보고서 받기
자연어 쿼리를 사용하여 시간 보고서를 받으세요. 예:
기간 옵션:
보고서 유형:
프로젝트별(기본값):
"Show time report for last month" "Get project hours for this week"고객별:
"Show time report by client for this month" "Get hours by client for Q1"작업별:
"Show time summary by task for January" "Get task breakdown for last week"팀원별:
"Show team hours for last week" "Get time report by user for this month"
보고서 세부 정보: 각 보고서에는 다음이 포함됩니다.
총 근무 시간
청구 가능 시간과 청구 불가능 시간
청구 가능 금액(허가가 있는 경우)
보고서 유형에 따른 프로젝트/클라이언트/작업/사용자 세부 정보
프로젝트 목록
사용 가능한 모든 Harvest 프로젝트를 나열하세요.
목록 작업
특정 프로젝트에 사용 가능한 작업을 나열하세요.
목록 항목
최근 시간 항목 보기:
구성
서버는 다음과 같은 환경 변수를 지원합니다.
HARVEST_ACCESS_TOKEN: 귀하의 Harvest 개인 액세스 토큰HARVEST_ACCOUNT_ID: 귀하의 Harvest 계정 IDSTANDARD_WORK_DAY_HOURS: 하루 종일 근무에 대한 기본 시간(기본값: 7.5)TIMEZONE: 귀하의 시간대(기본값: 호주/퍼스)
개발
서버는 다음을 사용하여 구축되었습니다.
타입스크립트
MCP SDK
자연어 날짜 구문 분석을 위한 크로노 노드
하베스트 API v2
기여하려면:
저장소를 포크하세요
기능 브랜치 생성
풀 리퀘스트 제출
특허
MIT 라이선스 - 자세한 내용은 라이선스를 참조하세요.