AI导哈

时间追踪自动化服务

Clockify MCP Server 是一个允许LLMs（如Cursor或Claude）与Clockify工作区交互的服务，实现高级时间追踪自动化和报告功能。

  • by inakianduaga
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 inakianduaga/clockify-mcp

使用说明

时钟化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=<YOUR_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许可证获得许可。请参阅 许可证 文件以获取详细信息。

相关 MCP