Harvest 자연어 시간 입력 MCP 서버

자연어를 사용하여 수확 시간 항목을 기록하고 휴가 요청에 대한 특수 처리를 지원하는 MCP 서버입니다. 이 서버는 자연어 입력을 이해하고 휴가 요청과 같은 일반적인 상황을 자동으로 처리하여 시간 추적을 더욱 직관적으로 만들어줍니다.

특징

• 🗣️ 자연어 시간 항목 구문 분석
• 🏖️ 특별 휴가 요청 처리(예: "오늘 병가입니다")
• ⏰ 설정 가능한 근무 시간
• 🌍 시간대 지원
• 🎯 자동 프로젝트 및 작업 매칭
• 📅 스마트 날짜 파싱(오늘, 어제 등)

필수 조건

• Node.js가 설치됨
• 수확 계정
• Harvest Developer Tools 의 개인 액세스 토큰
• 계정 ID(토큰과 같은 페이지에 표시됨)

설치

설치

1. Claude 데스크톱 앱 설치
2. 이 저장소를 복제하세요:

지엑스피1

3. 종속성을 설치하고 빌드합니다.

4. 설치 스크립트를 실행합니다.

5. 화면의 지시에 따라 다음을 입력하세요.
   • Harvest 개인 액세스 토큰( https://id.getharvest.com/developers 에서)
   • 수확 계정 ID
   • 표준 근무 시간(기본값: 7.5)
   • 시간대(기본값: 호주/퍼스)
6. Claude 데스크톱 앱을 다시 시작하세요

이제 Claude에서 자연어 시간 추적을 사용할 수 있습니다.

최신 정보 받기

최신 버전으로 업데이트하려면:

설치 스크립트는 Claude가 서버의 로컬 빌드를 사용하도록 구성했으므로, 끌어온 모든 업데이트는 다시 빌드한 후 자동으로 사용할 수 있습니다.

용법

서버는 Harvest와 상호 작용하기 위한 여러 도구를 제공합니다.

로그 시간

자연어를 사용하여 시간 항목을 기록합니다. 예:

정기 시간 항목:

휴가 요청(표준 근무 시간을 자동으로 사용):

시간 보고서 받기

자연어 쿼리를 사용하여 시간 보고서를 받으세요. 예:

1. 기간 옵션:

2. 보고서 유형:

• 프로젝트별(기본값):
  "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"

3. 보고서 세부 정보: 각 보고서에는 다음이 포함됩니다.

• 총 근무 시간
• 청구 가능 시간과 청구 불가능 시간
• 청구 가능 금액(허가가 있는 경우)
• 보고서 유형에 따른 프로젝트/클라이언트/작업/사용자 세부 정보

프로젝트 목록

사용 가능한 모든 Harvest 프로젝트를 나열하세요.

목록 작업

특정 프로젝트에 사용 가능한 작업을 나열하세요.

목록 항목

최근 시간 항목 보기:

구성

서버는 다음과 같은 환경 변수를 지원합니다.

• HARVEST_ACCESS_TOKEN : 귀하의 Harvest 개인 액세스 토큰
• HARVEST_ACCOUNT_ID : 귀하의 Harvest 계정 ID
• STANDARD_WORK_DAY_HOURS : 하루 종일 근무에 대한 기본 시간(기본값: 7.5)
• TIMEZONE : 귀하의 시간대(기본값: 호주/퍼스)

개발

서버는 다음을 사용하여 구축되었습니다.

• 타입스크립트
• MCP SDK
• 자연어 날짜 구문 분석을 위한 크로노 노드
• 하베스트 API v2

기여하려면:

1. 저장소를 포크하세요
2. 기능 브랜치 생성
3. 풀 리퀘스트 제출

특허

MIT 라이선스 - 자세한 내용은 라이선스를 참조하세요.