Harvest MCP

🚀 豐收時間追蹤 MCP 服務器

豐收時間追蹤 MCP 服務器用於與 Harvest 時間追蹤 API 進行交互，幫助用戶高效管理時間條目、項目和任務等信息。

點擊查看演示視頻

🚀 快速開始

本 MCP 服務器提供了豐富的工具，可與 Harvest 進行交互，下面為你詳細介紹其功能、安裝和使用方法。

✨ 主要特性

此 MCP 服務器提供以下工具以與 Harvest 進行交互：

用戶信息

• get_current_user：獲取有關已驗證用戶的信息

時間條目

• list_time_entries：列出時間條目，可選日期篩選
• get_time_entry：通過 ID 獲取特定時間條目
• create_time_entry：通過持續時間創建新的時間條目
• create_time_entry_via_start_end：使用開始/結束時間創建時間條目
• update_time_entry：更新現有時間條目
• delete_time_entry：刪除時間條目
• delete_time_entry_external_reference：刪除時間條目外部引用
• restart_time_entry：重新啟動已停止的時間條目
• stop_time_entry：停止正在運行的時間條目

項目和任務

• list_projects：列出所有項目，可選過濾
• list_tasks：列出所有任務，可選過濾

📦 安裝指南

先決條件

• Docker
• 帶有 API 憑證的 Harvest 賬戶

安裝

適用於 Claude 桌面用戶

如果你使用的是 Claude 桌面，則只需將以下配置添加到 MCP 配置文件中：

"harvest": {
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "HARVEST_ACCOUNT_ID",
    "-e",
    "HARVEST_TOKEN",
    "tommcl/harvest-mcp"
  ],
  "env": {
    "HARVEST_ACCOUNT_ID": "YOUR_ACCOUNT_ID",
    "HARVEST_TOKEN": "YOUR_API_TOKEN"
  }
}

⚠️ 重要提示

你需要安裝並運行 Docker Desktop。你可以在 Harvest 開發者工具頁面 獲取你的個人訪問令牌 (PAT) 和賬戶 ID。

選項 1：從 Docker Hub 拉取（適用於其他 MCP 客戶）

1. 直接從 Docker Hub 拉取 Docker 鏡像：

docker pull tommcl/harvest-mcp

選項 2：本地構建（用於開發）

1. 克隆倉庫：

git clone https://github.com/yourusername/harvest-mcp.git
cd harvest-mcp

2. 構建 Docker 鏡像：

docker build -t mcp/harvest .

然後在你的 MCP 配置中使用 "mcp/harvest" 而不是 "tommcl/harvest-mcp"。

⚠️ 重要提示

請用實際的 Harvest API 憑證替換示例憑證。你可以在 Harvest 開發者工具頁面 獲取你的個人訪問令牌 (PAT) 和賬戶 ID。

💻 使用示例

使用 Claude 桌面進行測試。