Clockify MCP (Inakianduaga)

时钟化MCP服务器

此MCP服务器允许LLM（如Cursor或Claude）与您的Clockify工作区交互，实现高级时间跟踪自动化和报告。使用此服务器，您可以：

• 列出工作区中的所有项目
• 列出工作区中的所有用户
• 为自己或任何用户（如果您有权限）添加和查找时间条目
• 为所有项目中的任何用户拉取时间表
• 使用Clockify摘要报告API按用户和项目生成每月或自定义日期范围的小时细分
• 与LLM集成，以自动化、汇总或分析您的时间跟踪数据

特性

• 项目列表： 列出已验证用户的所有项目
• getTimeEntries： 列出已验证用户的时间条目（带可选日期过滤器）
• addTimeEntry： 向项目添加时间条目
• 列出用户 ： 列出工作区中的所有用户
• getUserTimeEntries： 列出任何用户的时间条目（带可选日期过滤器）
• getSummaryReport： 按用户/项目获取日期范围的小时摘要报告（可选按用户IDs/projectIds筛选）。为任何用户或项目启用每月/每小时的细分。

快速入门（Docker——首选）

Cursor/Claude的MCP服务器配置

将以下内容添加到您的光标或克劳德 settings.json （替换 YOUR_API_KEY):

{
  "mcpServers": {
    "clockify-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "CLOCKIFY_API_KEY=",
        "ghcr.io/inakianduaga/clockify-mcp:latest"  
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

如何获取Clockify API密钥

1. 登录到您的 时钟化帐户.
2. 点击您的个人资料图标（右上角）并选择 个人资料.
3. 向下滚动到 API 部分。
4. 点击 生成 如果您没有API密钥，或者复制您现有的密钥。

贡献&CI/CD

该项目使用GitHub Actions在每次推送时自动构建Docker镜像并将其发布到GitHub容器注册表（GHCR） main.

• 图像URL:

ghcr.io/inakianduaga/clockify-mcp:latest

• 如何提取图像：

  docker pull ghcr.io/inakianduaga/clockify-mcp:latest

您可以在GitHub配置文件或存储库的“包”部分查看已发布的图像。

内存库和优化

使用游标和优化规则进行了开发。请参阅：https://github.com/Bhartendu-Kumar/rules_template

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。