Clockify MCP Server
2025.05.08
0
TypeScript时间跟踪自动化报告项目管理日程管理
Clockify MCP Server 是一个允许LLMs（如Cursor或Claude）与Clockify工作区交互的服务，提供高级时间跟踪自动化和报告功能。通过该服务，用户可以列出工作区中的所有项目和用户，添加和查找时间条目，提取用户在所有项目中的时间表，并生成按用户和项目分类的月度或自定义日期范围的小时数分解报告。此外，该服务还能与LLMs集成，自动化、总结或分析时间跟踪数据。
View on GitHub
Overview
基本能力
产品定位
Clockify MCP Server 是一个时间跟踪和报告自动化工具，专为需要高效管理时间和项目的团队设计。
核心功能
- listProjects: 列出认证用户的所有项目
- getTimeEntries: 列出认证用户的时间条目（可选日期过滤器）
- addTimeEntry: 向项目添加时间条目
- listUsers: 列出工作区中的所有用户
- getUserTimeEntries: 列出任何用户的时间条目（可选日期过滤器）
- getSummaryReport: 获取按用户/项目分类的小时数总结报告（可选用户ID/项目ID过滤器）
适用场景
- 团队时间跟踪和管理
- 项目时间分配和报告
- 自动化时间条目添加
- 时间数据分析与可视化
工具列表
- Docker: 用于容器化部署和运行服务
- GitHub Actions: 用于CI/CD自动化构建和发布
- Clockify API: 用于与Clockify工作区交互
常见问题解答
- 如何获取Clockify API Key？
- 登录Clockify账户
- 点击个人资料图标，选择“Profile”
- 滚动到“API”部分
- 点击“Generate”生成API Key或复制现有Key
使用教程
使用依赖
- 安装Docker
bash sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io
安装教程
- 拉取Docker镜像
bash docker pull ghcr.io/inakianduaga/clockify-mcp:latest - 配置MCP Server
在Cursor或Claude的
settings.json中添加以下配置（替换YOUR_API_KEY）：json { "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": [] } } }
调试方式
- 检查Docker容器是否运行
bash docker ps - 查看容器日志
bash docker logs <container_id>