fortyTimer MCP 服务器（只读）

一个轻量级 MCP 服务器，将 fortyTimer 安装实例的只读 API 以工具形式提供给 MCP 客户端（Claude Desktop、Claude Code 等）。 该服务器本身不包含任何业务逻辑——授权、可见性范围和数据最小化完全由用户所连接的 fortyTimer 安装实例强制执行。

要求

1. 一个 fortyTimer 安装实例，其许可证中包含 api_readonly（"fortyTimer API"） 许可模块。

2. 一个 个人 API 令牌，在 fortyTimer 中通过 个人资料 → 安全 → API 令牌 创建。该令牌仅显示一次。 它继承其所有者账户的可见性（管理员：所有用户，主管：自己的审批组，员工：仅本人），并且永远无法修改任何内容（仅 GET，read 权限）。

3. Node.js ≥ 18（作为 Claude Desktop 扩展安装时自动捆绑）。

安装（Claude Desktop 扩展）

通过双击或 Claude Desktop → 设置 → 扩展 安装打包好的 fortytimer-<version>.mcpb 文件。安装过程中会要求您提供两个值：

该令牌存储在操作系统钥匙串中，而非明文。

手动配置（任何 MCP 客户端）

{
    "mcpServers": {
        "fortytimer": {
            "command": "node",
            "args": ["/path/to/fortytimer-mcp/dist/index.js"],
            "env": {
                "FORTYTIMER_URL": "https://42.fortytimer.de",
                "FORTYTIMER_TOKEN": "<token>"
            }
        }
    }
}

从源代码构建

npm install
npm run build

打包为 Claude Desktop 扩展：

npm prune --omit=dev
npx @anthropic-ai/mcpb pack . fortytimer-<version>.mcpb
npm install

工具

所有工具均为只读（readOnlyHint）。日期范围在服务端限制为 366 天，列表每页分页 50 条记录（page 参数）。 时长以精确的整数分钟数加上预格式化的 小时:分钟 字符串返回。出于数据保护原因，病假申请的自由文本字段永远不会由 API 返回。

无需客户端即可测试

npx @modelcontextprotocol/inspector node dist/index.js

（在 Inspector 界面的"环境变量"下设置环境变量 FORTYTIMER_URL / FORTYTIMER_TOKEN。）

隐私政策

完整隐私政策：https://fortytimer.de/privacy-policy.md

摘要：

• 此 MCP 服务器不存储任何数据。它不持有任何数据库、缓存、日志文件或分析数据。

• 所有数据仅在用户自己的计算机与用户配置的 fortyTimer 安装实例之间流动——不涉及任何第三方服务，也不会向扩展作者传输任何数据。

• API 令牌由用户提供，由 MCP 客户端保管（Claude Desktop 将其存储在操作系统钥匙串中），并且仅作为 Bearer 请求头用于所配置的 fortyTimer URL。

• 哪些个人数据可见完全由所连接的 fortyTimer 安装实例决定：令牌继承其所有者账户的可见性，并且 fortyTimer 会在每个 API 响应中抑制特殊类别的数据（病假申请的自由文本）。

• 数据保留由所连接的 fortyTimer 安装实例管理（其运营者为数据控制者）；扩展本身不保留任何数据。

• 联系方式：info@fortytwo-consulting.de / https://fortytimer.de

安全

• 令牌应保存在个人用户的本地客户端配置中——切勿提交或分享。

• 令牌撤销：fortyTimer → 个人资料 → 安全 → API 令牌 → 删除（立即生效）；令牌的创建和删除会作为安全事件记录在 fortyTimer 审计日志中。

• API 速率限制：每分钟 60 次请求。

许可证

MIT——参见 LICENSE。