Clockify Timer MCP Server

用于管理 Clockify 计时器的极简 MCP 服务器。启动/停止计时器、查看正在运行什么以及查看最近的时间条目——全部通过 Claude 完成。

工具

设置

1. 获取你的 Clockify API 令牌

前往 Clockify 个人资料设置 → 滚动到“API” → 生成或复制你的 API 密钥。

2. 配置 Claude Desktop

将其添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "clockify": {
      "command": "npx",
      "args": ["tsx", "/ABSOLUTE/PATH/TO/clockify-mcp/src/index.ts"],
      "env": {
        "CLOCKIFY_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

3. 使用

• “为 API 重构工作启动计时器”

• “现在正在运行哪个计时器？”

• “停止计时器”

• “显示我最近 5 条时间条目”

• “在 Acme 项目上开始跟踪会议准备，计费”

安全说明

• 无共享可变状态 —— 客户端配置不可变，无全局单例

• 所有 Clockify ID 均经过验证，在 URL 插值前对照 24 字符十六进制模式进行校验（防止路径遍历）

• 不使用 axios —— 使用原生 fetch，零 HTTP 依赖漏洞

• 错误清理 —— API 错误会被截断，绝不会泄露认证头

• 快速失败 —— 如果缺少 API 令牌则立即退出

• 创建时 0 个 npm audit 漏洞