mcpField
C
Clockify MCP Server

Clockify MCP Server

本地服务
github.com/inakianduaga生产力1577 周前更新
代码仓库

关于 Clockify MCP Server

Clockify MCP Server 将大模型连接到 Clockify 工作区，以便执行时间记录操作和生成报告。它支持时间条目、工作区用户与项目，以及按日期范围汇总数据。

主要功能

  1. 01列出工作区项目和用户
  2. 02查看并添加时间条目
  3. 03获取用户工时表
  4. 04按用户和项目汇总工时

适用场景

  1. 01通过大模型记录项目工时
  2. 02查看指定日期范围内的用户工时表
  3. 03生成月度或自定义周期的工时明细

MCP 相关

它将 Clockify 的项目、用户、时间条目和汇总报告操作作为工具提供给 Cursor、Claude 等 MCP 客户端。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "clockify": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CLOCKIFY_API_KEY",
        "ghcr.io/inakianduaga/clockify-mcp:latest"
      ],
      "env": {
        "CLOCKIFY_API_KEY": "<CLOCKIFY_API_KEY>"
      }
    }
  }
}
启动命令docker run -i --rm -e CLOCKIFY_API_KEY ghcr.io/inakianduaga/clockify-mcp:latest
需要配置的环境变量
CLOCKIFY_API_KEY密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
ocighcr.io/inakianduaga/clockify-mcp:latest

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Build Status Docker Image

Clockify MCP 服务

Clockify MCP 服务

此 MCP 服务可让大模型（例如 Cursor 或 Claude）与您的 Clockify 工作区交互，从而实现高级时间跟踪自动化和报告。借助此服务，您可以：

  • 列出工作区中的所有项目
  • 列出工作区中的所有用户
  • 为自己或任何用户添加和查询时间条目（如果您拥有相应权限）
  • 获取任何用户在所有项目中的工时表
  • 使用 Clockify 汇总报告 API，按用户和项目生成月度或自定义日期范围的工时明细
  • 与大模型集成，以自动化、汇总或分析您的时间跟踪数据

Clockify 示例

功能

  • listProjects： 列出已认证用户的所有项目
  • getTimeEntries： 列出已认证用户的时间条目（可选日期筛选条件）
  • addTimeEntry： 向项目添加时间条目
  • listUsers： 列出工作区中的所有用户
  • getUserTimeEntries： 列出任何用户的时间条目（可选日期筛选条件）
  • getSummaryReport： 获取指定日期范围内按用户／项目划分的工时汇总报告（可选按 userIds／projectIds 筛选）。支持按月／小时查看任何用户或项目的明细。

快速开始（Docker — 推荐）

Cursor／Claude 的 MCP 服务配置

将以下内容添加到 Cursor 或 Claude 的 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. 登录您的 Clockify 账户。
  2. 点击个人资料图标（右上角），然后选择 个人资料。
  3. 向下滚动到 API 部分。
  4. 如果您还没有 API 密钥，请点击 Generate；或者复制已有密钥。

贡献与 CI/CD

此项目使用 GitHub Actions，在每次推送到 main 时自动构建 Docker 镜像并将其发布到 GitHub Container Registry（GHCR）。

  • 镜像 URL： ghcr.io/inakianduaga/clockify-mcp:latest
  • 拉取镜像的方法： 
    docker pull ghcr.io/inakianduaga/clockify-mcp:latest

您可以在 GitHub 个人资料或仓库的 “Packages” 部分查看已发布的镜像。

记忆库与优化

开发过程中使用了 cursor 和经过优化的规则。请参阅：https://github.com/Bhartendu-Kumar/rules_template

许可证

此项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。