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