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