AI导哈

时间跟踪管理服务

提供27种工具用于通过Model Context Protocol全面管理Clockify时间跟踪，包括计时器、时间条目、项目、任务、标签、客户、工作区、用户和报告等功能。

  • by tedyno
  • Go
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 tedyno/ticktock-mcp

使用说明

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 生成详细报告

许可证

麻省理工学院

相关 MCP