TimeTagger MCP Server

TimeTagger MCP 服务

这是一个用于与 TimeTagger 交互的模型上下文协议（MCP）服务。它提供了工具，让你可以通过 Claude 或其他兼容 MCP 的 AI 助手查询和管理时间记录。

功能

• 查询特定时间范围内的时间记录
• 创建新的时间记录
• 更新现有记录
• 隐藏／删除记录
• 按标签获取时间摘要
• 启动和停止计时器
• 管理 TimeTagger 设置

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 Inspector 界面，你可以在其中测试工具和资源。

为 Claude Desktop 安装

要与 Claude Desktop 配合使用：

fastmcp install timetagger_mcp.py

可用工具

• 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)：获取不同标签所花时间的摘要
• get_settings()：获取所有 TimeTagger 设置
• update_setting(key, value)：更新一项 TimeTagger 设置

可用资源

• timetagger://config：获取 TimeTagger 配置
• timetagger://records/{timerange}：获取指定时间范围内的记录
• timetagger://settings：获取所有设置
• timetagger://updates/{since}：获取指定时间戳之后的更新