Timetagger MCP

🚀 時間標籤器 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"
  }
}

📦 手動安裝

1. 確保已安裝 uv：

   brew install uv
   

2. 安裝所需的依賴項：

   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 設置

📚 詳細文檔

可用工具

可用資源