Timetagger MCP

TimeTagger MCP服務是一個用於與TimeTagger時間記錄工具交互的協議服務器，提供查詢、創建、更新時間記錄以及管理計時器和設置的功能。

日程管理開發者工具 #時間記錄 #MCP服務 #計時管理 .Python

評分 : 2.5分

下載量 : 8

更新時間 : 2025-04-29

什麼是TimeTagger MCP 服務器？

TimeTagger MCP 服務器是一個基於Model Context Protocol（MCP）的工具，旨在幫助您輕鬆管理和查詢時間記錄。它提供了多種功能，例如查詢特定時間段內的記錄、創建新記錄、更新現有記錄以及獲取時間彙總報告。

如何使用TimeTagger MCP 服務器？

使用該服務器非常簡單。首先，您需要安裝並配置好環境變量，然後可以通過命令行或圖形界面與服務器交互。您可以查詢記錄、啟動計時器、更新設置等。

適用場景

TimeTagger MCP 服務器非常適合需要高效管理個人或團隊時間的人群，例如自由職業者、項目經理或任何希望優化時間分配的專業人士。

主要功能

查詢時間記錄根據特定的時間範圍查詢您的時間記錄。

創建新記錄快速添加新的時間記錄，包括描述、開始時間和結束時間。

更新現有記錄修改已有的時間記錄以反映最新的變化。

隱藏/刪除記錄隱藏不需要的時間記錄或將它們永久刪除。

時間彙總按標籤統計某段時間內的時間花費情況。

啟動/停止計時器即時跟蹤正在進行的任務。

管理設置調整TimeTagger的各種配置選項。

優勢與侷限性

優勢

易於使用且功能強大。

支持多種語言和平臺。

強大的數據分析能力。

開放源碼，便於二次開發。

侷限性

需要API密鑰進行身份驗證。

對網絡環境有一定要求。

某些高級功能可能需要額外付費。

如何使用

安裝依賴

確保已安裝uv工具，並運行以下命令安裝所需依賴： ```bash uv pip install -r requirements.txt ```

配置環境變量

設置您的TimeTagger API密鑰和API URL作為環境變量。 ```bash export TIMETAGGER_API_KEY="your-api-key-here" export TIMETAGGER_API_URL="https://your-timetagger-instance.com/api/v2" ```

啟動服務器

在開發模式下運行服務器以測試功能： ```bash fastmcp dev timetagger_mcp.py ```

使用案例

查詢最近一個月的記錄獲取過去30天內的時間記錄。

啟動計時器開始記錄當前任務。

常見問題

如何安裝TimeTagger MCP 服務器？

忘記了我的API密鑰怎麼辦？

是否可以自定義我的時間記錄標籤？

🚀 時間標籤器 MCP 服務器

時間標籤器 MCP 服務器是一個用於與 TimeTagger 交互的 Model Context Protocol (MCP) 服務器。它提供了一系列工具，可用於查詢和管理您的時間記錄，並且可以通過 Claude 或其他兼容 MCP 的 AI 助手使用。

🚀 快速開始

安裝

📦 Claude Desktop 安裝

將以下內容添加到您的 claude_desktop_config.json 文件中：

"timetagger": {
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/regismesquita/timetagger-mcp",
    "timetagger-mcp"
  ],
  "env": {
    "TIMETAGGER_API_KEY": "your-api-key-here",
    "TIMETAGGER_API_URL": "https://your-timetagger-instance.com/api/v2"
  }
}

📦 手動安裝

確保已安裝 uv：
```
brew install uv
```
安裝所需的依賴項：
```
uv pip install -r requirements.txt
```

配置

服務器需要您設置 TimeTagger API 密鑰作為環境變量：

export TIMETAGGER_API_KEY="your-api-key-here"
export TIMETAGGER_API_URL="https://your-timetagger-instance.com/api/v2"

使用

💻 以開發模式運行

用於測試和開發：

fastmcp dev timetagger_mcp.py

這將啟動 MCP 檢查器界面，您可以在其中測試工具和資源。

💻 安裝到 Claude Desktop

要與 Claude Desktop 一起使用：

fastmcp install timetagger_mcp.py

✨ 主要特性

在特定時間段內查詢時間記錄
創建新的時間記錄
更新現有記錄
隱藏/刪除記錄
按標籤獲取時間摘要
啟動和停止計時器
管理 TimeTagger 設置

📚 詳細文檔

可用工具

工具名稱	功能描述
`get_records(start_time, end_time)`	在特定時間段內獲取記錄
`get_recent_records(hours)`	獲取過去 N 小時的記錄
`get_today_records()`	獲取當天的記錄
`create_record(description, start_time, end_time)`	創建新記錄
`update_record(key, description, start_time, end_time)`	更新現有記錄
`hide_record(key)`	隱藏/刪除記錄
`start_timer(description)`	啟動新的計時器
`stop_timer(key)`	停止運行中的計時器
`find_records_by_tag(tag, days)`	按標籤查找記錄
`get_time_summary(days)`	獲取過去 N 天的時間摘要
`get_settings()`	獲取所有 TimeTagger 設置
`update_setting(key, value)`	更新某個 TimeTagger 設置

可用資源

資源名稱	功能描述
`timetagger://config`	獲取 TimeTagger 配置
`timetagger://records/{timerange}`	在特定時間段內獲取記錄
`timetagger://settings`	獲取所有設置
`timetagger://updates/{since}`	獲取自某個時間戳以來的更新