Timetagger MCP

TimeTagger MCP服务是一个用于与TimeTagger时间记录工具交互的协议服务器，提供查询、创建、更新时间记录以及管理计时器和设置的功能。

日程管理开发者工具 #时间记录 #MCP服务 #计时管理 .Python

评分 : 2.5分

下载量 : 7

更新时间 : 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}`	获取自某个时间戳以来的更新