AI导哈

时间跟踪服务器

一个用于管理时间条目和计时器的MCP服务器，适用于时间跟踪和工作日志记录场景。

  • by ben-askphill
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ben-askphill/productive-mcp

使用说明

生产时间跟踪MCP服务器

用于管理时间条目和计时器的MCP服务器 高效的.

特性

  • 列出项目 -查找您的项目
  • 列出服务 -在项目中查找计费服务
  • 记录时间条目 -创建包含小时、日期和注释的时间条目
  • 编辑时间条目 -更新现有条目
  • 删除时间条目 -删除条目
  • 启动/停止计时器 -实时跟踪时间

设置

1.安装依赖项并构建

cd productive-mcp
npm install
npm run build

2.添加到克劳德代码

运行以下命令（将路径替换为实际路径）：

claude mcp add productive -e PRODUCTIVE_API_TOKEN=your_token_here -e PRODUCTIVE_ORGANIZATION_ID=21562 -e PRODUCTIVE_USER_ID=1159352 -- node /Users/benrosenberg/productive/productive-mcp/dist/server.js

或手动添加到 ~/.claude.json:

{
  "mcpServers": {
    "productive": {
      "command": "node",
      "args": ["/Users/benrosenberg/productive/productive-mcp/dist/server.js"],
      "env": {
        "PRODUCTIVE_API_TOKEN": "your_token_here",
        "PRODUCTIVE_ORGANIZATION_ID": "21562",
        "PRODUCTIVE_USER_ID": "1159352"
      }
    }
  }
}

3.添加到Claude.ai桌面（可选）

将相同的配置添加到：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json

配置

变量 描述
PRODUCTIVE_API_TOKEN 您的个人访问令牌（设置>集成>API访问）
PRODUCTIVE_ORGANIZATION_ID 从您的生产URL（例如。， 21562 从 app.productive.io/21562-ask-phill/)
PRODUCTIVE_USER_ID 您在Productive中的用户ID

用法示例

连接后，问克劳德：

  • “在Productive中列出我的项目”
  • “显示项目12345的服务”
  • “今天记录2小时服务6789”
  • “显示我上周的时间条目”
  • “启动服务计时器6789”
  • “停止计时器123”
  • “删除时间条目456”

可用工具

工具 说明
list_projects 列出项目（按状态或搜索筛选）
list_services 列出项目的服务
list_time_entries 查看最近的时间条目
create_time_entry 记录服务时间
update_time_entry 编辑现有时间条目
delete_time_entry 删除时间条目
list_timers 显示活动计时器
start_timer 开始跟踪时间
stop_timer 停止活动计时器

理解Productive的数据模型

  • 项目 包含 预算
  • 预算 包含 服务 （可计费的行项目，如“开发”、“设计”）
  • 时间条目 已登录 服务
  • 计时器 实时跟踪时间并创建/更新时间条目

因此，要记录时间，工作流程是：

  1. 查找您的项目(list_projects)
  2. 在该项目中查找服务(list_services project_id=...)
  3. 记录服务时间(create_time_entry service_id=...)

相关 MCP