Timetagger MCP

定时器MCP服务器

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

特性

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

Claude桌面安装

将此添加到您的 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. 确保你有 紫外线 安装：

   brew install uv

1. 安装所需的依赖项：

   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

可用工具

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