TrackingTime MCP Server

跟踪时间MCP服务器

一 MCP（模型上下文协议） 将Claude等人工智能助手连接到 追踪时间 API v4。通过自然语言管理项目、任务、时间跟踪、员工分配和客户。

快速开始

1.获取您的TrackingTime凭据

• 应用程序密码： 追踪时间→ 管理→ 用户设置→ 应用程序和集成→ 创建新的应用程序密码
• 帐户ID: 登录时在您的TrackingTime URL或帐户设置中可见

2.添加到您的AI助手

克劳德代码：

claude mcp add trackingtime -e TT_APP_PASSWORD=your-app-password -e TT_ACCOUNT_ID=your-account-id -- npx trackingtime-mcp

克劳德桌面版 (claude_desktop_config.json):

{
  "mcpServers": {
    "trackingtime": {
      "command": "npx",
      "args": ["trackingtime-mcp"],
      "env": {
        "TT_APP_PASSWORD": "your-app-password",
        "TT_ACCOUNT_ID": "your-account-id"
      }
    }
  }
}

添加后重新启动助手。

替代方案：从源代码安装

如果您更喜欢在本地克隆和构建：

git clone https://github.com/ficus33/trackingtime-mcp.git
cd trackingtime-mcp
npm install
npm run build
cp .env.example .env   # then edit .env with your credentials

然后将您的助手指向本地版本：

claude mcp add trackingtime -- node /path/to/trackingtime-mcp/dist/index.js

工具

项目

任务

时间追踪

时间条目

事件标签

用户和员工

用户组

客户

服务

团队（工作区）

报告

通知

网络钩子

减少刀具数量

默认情况下，所有93个工具都处于活动状态。如果你发现这为你的人工智能助手增加了太多的上下文，你可以克隆你不需要的仓库、注释输出工具 src/tools.ts 随着 /* */，然后运行 npm run build 打造更苗条的身材。

测试

使用 MCP检查员 交互式测试工具：

npx @modelcontextprotocol/inspector npx trackingtime-mcp

API注释

需要注意的几个TrackingTime API怪癖：

• duration 和 accumulated_time 在里面 秒
• estimated_time 和 worked_hours 在里面 小时
• 时间条目在API中称为“事件”
• 当计时器已经运行时启动计时器会返回错误502--use stop_running_task=true 自动停止当前计时器
• 日期使用 YYYY-MM-DD，日期时间使用 yyyy-MM-dd HH:mm:ss

认证

此服务器使用TrackingTime的 应用程序密码 身份验证。您的真实密码永远不会被存储。应用程序密码以HTTP基本身份验证的形式发送(API_TOKEN:)通过SSL。

如果应用程序密码被泄露，请在TrackingTime中撤销它并创建一个新的密码——无需更改您的帐户密码。

许可证

麻省理工学院