金大哥 - timetagger-mcp MCP 详情

article

README

🚀 时间标签器 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} | 获取自某个时间戳以来的更新 |

timetagger-mcp