Harvest MCP Server

🚀 基於自然語言的時間錄入 Harvest MCP 服務器

這是一個 MCP 服務器，允許用戶使用自然語言進行 Harvest 時間錄入，還能對請假請求進行特殊處理。它通過理解自然語言輸入，自動處理常見場景（如請假請求），讓時間跟蹤變得更加直觀。

🚀 快速開始

本服務器可讓你輕鬆使用自然語言進行 Harvest 時間錄入。按照以下步驟操作，即可開啟便捷的時間跟蹤之旅。

✨ 主要特性

• 🗣️ 支持自然語言時間錄入解析。
• 🏖️ 能特殊處理請假請求（例如：“我今天病假”）。
• ⏰ 可對正常工作日時長進行配置。
• 🌍 提供時區支持。
• 🎯 可自動匹配項目和任務。
• 📅 支持智能日期解析（如今天、昨天等）。

📦 安裝指南

安裝

1. 安裝 Claude 桌面應用程序。
2. 克隆此倉庫：

git clone https://github.com/adrian-dotco/harvest-mcp-server.git
cd harvest-mcp-server

3. 安裝依賴項並構建：

npm install
npm run build

4. 運行設置腳本：

node build/setup.js

5. 按照提示輸入以下信息：
   • Harvest 個人訪問令牌（從 https://id.getharvest.com/developers 獲取）
   • Harvest 賬戶 ID
   • 標準工作日時長（默認：7.5 小時）
   • 時區（默認：澳大利亞珀斯）
6. 重啟 Claude 桌面應用程序。

完成以上步驟後，你就可以在 Claude 中使用自然語言進行時間跟蹤啦。

更新

若要更新到最新版本，可執行以下命令：

git pull
npm install
npm run build

設置腳本已配置為使用本地構建的服務器，因此重建後任何更新都會自動生效。

💻 使用示例

基礎用法

該服務器提供了與 Harvest 交互的多種工具：

log_time

使用自然語言記錄時間，示例如下： 常規時間錄入：

"今天在項目 X 上開發工作 2 小時"
"昨天在項目 Y 上測試 45 分鐘"
"上週五在項目 Z 上開會 3.5 小時"

請假請求（自動使用標準工作日時長）：

"我今天病假"
"我今天不舒服"
"下週休假"

get_time_report

使用自然語言查詢獲取時間報告，示例如下：

1. 時間段選項：

"顯示上個月的時間報告"
"獲取本週的摘要"
"顯示 1 月 1 日到 1 月 31 日的小時數"
"顯示 Q1 的時間"
"顯示昨天的小時數"

2. 報告類型：

• 按項目彙總
• 按任務分組
• 顯示趨勢分析

get_help

獲取可用命令列表和簡要說明：

get_help

📚 詳細文檔

可以通過設置以下環境變量來配置服務器：

🔧 技術細節

技術棧

• 後端：Node.js, Express
• 數據庫：MongoDB
• 編程語言：JavaScript/TypeScript

貢獻指南

1. 克隆倉庫並安裝依賴：

git clone https://github.com/adrian-dotco/harvest-mcp-server.git
cd harvest-mcp-server
npm install

2. 創建功能分支並提交更改：

git checkout -b feature/new-feature
# 進行修改
git add .
git commit -m "添加新功能"
git push origin feature/new-feature

3. 提交拉取請求到主分支。

📄 許可證

該項目使用 MIT 許可證。有關詳細信息，請參閱 LICENSE 文件。