AI导哈

时间追踪服务

本地时间追踪MCP服务器，自动记录AI编程代理的工作时间，无需外部服务或账户，所有数据保存在本地。

  • by TLmaK0
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 TLmaK0/timesheet-ai

使用说明

时间表ai

用于本地时间跟踪的MCP服务器。直接从您的AI编码代理跟踪您如何度过时间——没有外部服务，没有帐户，一切都留在您的机器上。

为什么

AI编码代理（Claude Code、Cursor、Windsurf……）已经知道你在做什么。这个MCP服务器让他们 自动跟踪您的时间 当你工作时，你不必记住启动/停止计时器或手动填写时间表。

在一天结束时，您会有一个完整的日志，记录您所做的工作，以及工作时间，按项目和任务分组，准备导出到公司的时间表系统。

特性

  • 自动会话跟踪 --每个代理会话都会记录其项目名称
  • 启动/停止计时器 --实时跟踪时间，启动新计时器时自动停止之前的计时器
  • 手动记录 --事后记录时间条目
  • 标签和过滤器 --使用标签对条目进行分类，按任务/标签/日期/项目进行筛选
  • 摘要 --获取按任务分组的时间报告
  • 每个会话文件 --每个会话都存储为单独的JSON文件 ~/.mcp-timesheet/
  • 完全本地化 --没有外部服务，没有帐户，没有数据离开您的机器

工具

工具 说明
start_timer 为任务启动计时器（自动停止任何正在运行的计时器）
stop_timer 停止当前正在运行的计时器
timer_status 检查当前计时器的运行时间
log_time 手动记录任务的时间
get_task_summary 使用可选筛选器按任务分组获取时间摘要
list_entries 使用可选筛选器列出时间条目
delete_entry 按ID删除时间条目

安装

npm install -g timesheet-ai

或者从源代码运行：

git clone https://github.com/TLmaK0/timesheet-ai.git
cd timesheet-ai
npm install
npm run build

设置

克劳德代码

添加到全局配置(~/.claude.json 在...之下 mcpServers):

{
  "mcpServers": {
    "timesheet-ai": {
      "command": "npx",
      "args": ["-y", "timesheet-ai"]
    }
  }
}

然后将以下内容添加到您的项目中 CLAUDE.md （或全局指令），以便代理自动跟踪时间：

## Time tracking

You are connected to a time tracking system. Session time is tracked automatically,
but you MUST describe what you're working on.

Every time the user gives you a new task or changes topic, call `start_timer` with:
- task: a concise description (e.g. "Fix login bug", "Add CSV export")
- tags: relevant categories (e.g. "dev", "bugfix", "review", "docs")

Call `start_timer` BEFORE you start working on the task.
When a task is completed and there's no new task, call `stop_timer`.
When the user asks about time spent, use `get_task_summary` or `list_entries`.

克劳德桌面版

添加到您的Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "timesheet-ai": {
      "command": "npx",
      "args": ["-y", "timesheet-ai"]
    }
  }
}

其他MCP客户端

任何兼容MCP的客户端都可以使用此服务器。只需指出：

npx -y timesheet-ai

使用示例

配置后，您的AI代理将在您工作时跟踪时间。您还可以直接与它交互：

  • 启动API重构的计时器，标记为dev和后端
  • “停止计时器”
  • “为设计审查会议记录45分钟”
  • “我这周花了多少时间？”
  • “按任务显示3月份的摘要”
  • “列出标记为bugfix的所有条目”

数据存储

所有时间条目都存储在本地 ~/.mcp-timesheet/ 作为单独的JSON会话文件。没有数据发送到任何外部服务。

许可证

麻省理工学院

相关 MCP