Zeitwerk MCP Server

时间表 MCP 服务器

描述

此扩展将Claude Desktop连接到 时间表，一款面向自由职业者的专业时间跟踪和发票应用程序。它将Claude连接到Zeitwerk本地HTTP API（运行于 127.0.0.1:27432)，让您完全通过自然语言记录时间、管理项目和客户、生成报告和创建发票，而无需离开您的对话。

先决条件： Zeitwerk必须在您的机器上安装并运行。扩展仅与当地的Zeitwerk API通讯；任何数据都不会离开你的设备。

特性

• 定时器控制 --通过自然语言启动和停止应用内计时器（“在网站重新设计时启动计时器”）
• 时间记录 --用自然语言记录小时数（“网站重新设计2.5小时——修复导航错误”）
• 报告 --按天、周、月或自定义范围获取时间表和收益摘要
• 开具发票 --从未开票时间开始起草、确认和创建发票；将发票标记为已付款；下载PDF
• 项目和客户管理 --无需打开应用程序即可创建和更新客户和项目
• 导入 --批量导入时间条目来自 .xlsx, .xls，或 .csv 文件
• 仪表盘 --即时快照今天的小时数、本周、本月和未付发票总额

安装

直接从Claude Desktop Extensions目录安装：

设置→ 扩展→ 浏览→ 搜索“Zeitwerk”

或者通过将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "zeitwerk": {
      "command": "node",
      "args": ["/path/to/zeitwerk-mcp-server/index.js"],
      "env": {
        "TOKEN": "your-zeitwerk-api-token"
      }
    }
  }
}

配置

1. 打开 设置→ 扩展→ Zeitwerk MCP服务器
2. 粘贴您的 时间表 API 令牌 （发现于Zeitwerk→ 偏好→ API)
3. 在开始对话之前，请确保Zeitwerk桌面应用程序正在运行

可用工具

例子

示例1：启动计时器

用户提示： “启动Acme Corp网站重新设计项目的计时器——在黑暗模式下工作”

预期行为：

• 扩展查找匹配的客户和项目
• 根据给定的描述启动该项目的应用内Zeitwerk计时器
• 确认计时器正在以开始时间运行

示例2：停止计时器

用户提示： “停止计时器”

预期行为：

• 扩展程序停止运行Zeitwerk定时器
• 报告节省的时间条目，包括经过的小时数和项目名称

示例3：日志时间（手动）

用户提示： “在Acme Solutions云迁移项目上记录3小时——审查拉取请求”

预期行为：

• 扩展查找匹配的客户和项目
• 创建具有给定持续时间和描述的时间条目
• 用日期、小时和项目名称确认条目

示例4：获取收益报告

用户提示： “我这个月从Cascade Partners赚了多少钱？”

预期行为：

• 扩展程序获取过滤到Cascade Partners的当月时间条目
• 根据项目费率计算总小时数和收入
• 返回按项目细分的摘要

示例5：创建发票

用户提示： “为Blue Ridge Consulting创建2026年3月所有未开票时间的发票”

预期行为：

• 查找Blue Ridge Consulting客户ID
• 获取2026年3月的未开票时间条目
• 显示发票摘要草稿以供确认
• 在Zeitwerk中创建发票

示例6：从文件导入时间条目

用户提示： “您能将excel表格从工作文件夹导入Zeitwerk的Acme Corp营销项目吗？”

预期行为：

• 扩展程序读取给定路径下的Excel文件
• 查找Zeitwerk的Acme公司和营销项目
• 解析excel表中的时间条目，以便以后验证导入
• 通过向Zeitwerk发送excel表格将时间条目导入Zeitwerks
• 报告导入了多少条目，验证它们并标记任何无法解析的行

隐私

完整隐私政策： https://www.hocmodo.nl/zeitwerk-mcp-privacy/

隐私联系人： joost.evertse@hocmodo.nl

支持

• 问题和功能请求：
• 电子邮件： joost.evertse@hocmodo.nl
• 博客： 博客.joustie.nl