ticktock mcp
MCP服务器 时钟化 时间追踪。提供27个工具,通过 模型上下文协议.
特性
- 计时器 --启动、停止、获取当前运行计时器
- 时间条目 --创建、列出、更新、删除
- 项目 --CRUD操作
- 任务 --CRUD操作(每个项目)
- 标签 --CRUD操作
- 客户 --CRUD操作
- 工作区 --列出可用工作区
- 用户 --当前用户,列出工作区用户
- 报告 --带过滤器的摘要和详细报告
每个工具都支持一个可选 workspace_id 参数来覆盖默认工作区。
安装
Docker(推荐)
docker pull tedyno/ticktock-mcp:latest走
go install github.com/tedyno/ticktock-mcp@latest或者从源代码构建:
git clone https://github.com/tedyno/ticktock-mcp.git
cd ticktock-mcp
go build -o ticktock-mcp .配置
API密钥
通过环境变量设置Clockify API密钥:
export CLOCKIFY_API_KEY=your-api-key或者在以下位置创建配置文件 ~/.config/ticktock-mcp/config.json:
{
"api_key": "your-api-key",
"workspace_id": "optional-default-workspace-id"
}环境变量优先于配置文件。
您可以从获取API密钥 时钟设置.
使用Claude代码
码头工人
{
"mcpServers": {
"clockify": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "CLOCKIFY_API_KEY", "tedyno/ticktock-mcp:latest"],
"env": {
"CLOCKIFY_API_KEY": "your-api-key"
}
}
}
}或者通过CLI:
claude mcp add clockify -e CLOCKIFY_API_KEY=your-api-key -- docker run -i --rm -e CLOCKIFY_API_KEY tedyno/ticktock-mcp:latest二进制
{
"mcpServers": {
"clockify": {
"command": "ticktock-mcp",
"env": {
"CLOCKIFY_API_KEY": "your-api-key"
}
}
}
}或者通过CLI:
claude mcp add clockify -e CLOCKIFY_API_KEY=your-api-key -- ticktock-mcp可用工具
| 工具 | 说明 |
|---|---|
clockify_timer_start | 启动新计时器 |
clockify_timer_stop | 停止运行计时器 |
clockify_timer_current | 获取运行计时器 |
clockify_time_entry_list | 列出时间条目 |
clockify_time_entry_create | 创建手动时间条目 |
clockify_time_entry_update | 更新时间条目 |
clockify_time_entry_delete | 删除时间条目 |
clockify_project_list | 列出项目 |
clockify_project_create | 创建项目 |
clockify_project_update | 更新项目 |
clockify_project_delete | 删除项目 |
clockify_task_list | 列出项目中的任务 |
clockify_task_create | 创建任务 |
clockify_task_update | 更新任务 |
clockify_task_delete | 删除任务 |
clockify_tag_list | 列表标签 |
clockify_tag_create | 创建标签 |
clockify_tag_update | 更新标签 |
clockify_tag_delete | 删除标签 |
clockify_client_list | 列出客户 |
clockify_client_create | 创建客户端 |
clockify_client_update | 更新客户端 |
clockify_client_delete | 删除客户端 |
clockify_workspace_list | 列出工作区 |
clockify_user_current | 获取当前用户 |
clockify_user_list | 列出工作区用户 |
clockify_report_summary | 生成摘要报告 |
clockify_report_detailed | 生成详细报告 |
许可证
麻省理工学院
