AI导哈

时间记录管理服务器

TimeTagger MCP Server是一个用于通过Claude或其他MCP兼容AI助手查询和管理时间记录的模型上下文协议服务器。

  • by regismesquita
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 regismesquita/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

  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

可用工具

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

相关 MCP