mite

mite-mcp-server

English · Deutsch

向 Claude 询问你的 mite 工时记录——“今年每个月我们在各个项目上花了多少小时，赚了多少钱？”——并获取 mite 自行计算的报告结果，而不是让模型对数百条记录进行累加。

非官方项目。与 mite GmbH 无关，也未获得其认可。

为什么选择此服务

• 开箱即用的报告。 mite 在服务端进行分组（group_by），因此一整年的数据只需一次请求，就能得到一个简洁的答复。
• 默认安全。 初始为只读模式。只有启用相应模式后，写入工具才会出现；还可以通过允许列表进一步缩小范围。模式和允许列表之外的工具甚至不会显示给 Agent。
• 密钥由你掌控。 仅从环境变量读取 API 密钥，并通过请求头发送；从所有错误消息中移除，且绝不记录日志。

工具

工具	模式	功能说明
mite_whoami	只读	账户、你的用户和角色、服务模式及已启用的工具
mite_report_projects_by_month	只读	某个时间段内每个项目每月的工时和收入；可按客户、项目、服务、用户、是否计费进行筛选
mite_report	只读	按 1–3 个维度（客户、项目、服务、用户、日、周、月、年）分组的工时、收入和占比；筛选条件相同
mite_report_budget	只读	项目整个生命周期内的预算、已用金额、剩余金额和使用百分比；以分钟表示工时，以货币单位的分表示金额
mite_report_billable_ratio	只读	某个时间段内的可计费与不可计费工时及可计费工时百分比；可选按客户、项目、用户或月份分组
mite_list_time_entries	只读	某个时间段内的单条工时记录，按时间从新到旧排列；支持筛选、limit/page、has_more
mite_get_time_entry	只读	按 ID 获取一条工时记录
mite_tracker_status	只读	跟踪器是否正在运行，以及当前跟踪的记录
mite_list_customers	只读	客户，可列出启用或已归档的客户（archived: true）
mite_list_projects	只读	项目及其客户和预算，可列出启用或已归档的项目
mite_list_services	只读	服务，可列出启用或已归档的服务
mite_list_users	只读	用户和角色（不含电子邮件和费率），可列出启用或已归档的用户
mite_create_time_entry	写入	创建工时记录；dry_run: true 会显示预览，但不会写入
mite_update_time_entry	写入	修改工时记录字段（不可修改的字段见下文）；dry_run: true 会显示当前值与新值，但不会写入
mite_start_tracker	写入	开始跟踪一条工时记录
mite_stop_tracker	写入	停止跟踪一条工时记录
mite_delete_time_entry	写入	分两步删除一条工时记录，并使用确认令牌（见下文）；锁定记录见“锁定的记录”
mite_create_customer、mite_create_project、mite_create_service	管理员	创建客户、项目或服务；dry_run: true 会显示预览，但不会写入
mite_update_customer、mite_update_project、mite_update_service	管理员	修改字段；archived: true 会归档，archived: false 会恢复；dry_run: true 不会写入
mite_delete_customer、mite_delete_project、mite_delete_service	管理员	分两步删除，并使用确认令牌（见下文）；如果 mite 拒绝删除，例如仍存在工时记录，则会返回错误

使用确认令牌删除

mite_delete_time_entry 和 3 个主数据删除工具都不会在首次调用时执行删除：

1. 使用 id 调用（或设置 dry_run: true）。工具会返回条目预览和 confirm_token；不会删除任何内容。
2. 使用相同的 id 和 confirm_token 再次调用。只有这时才会执行删除。

令牌与工具及其参数绑定，有效期为 5 分钟，只能使用一次，且只有正在运行的服务进程知道该令牌（重启后令牌会失效）。

如果 MCP 客户端支持 elicitation，第二次调用（以及任何带有 force: true 和令牌的调用）还会向用户简要说明将要删除或强制执行的内容并征求确认。只有用户接受后才会执行操作。如果用户拒绝或取消，不会向 mite 发送任何内容，令牌会保持未使用状态，直到过期。不支持 elicitation 的客户端不会征求确认；仅凭令牌即可执行操作。

**客户端支持情况（截至 28.10.2026 的检查结果）：**Claude Desktop 尚不支持 elicitation，因此不会显示对话框；在该客户端中删除仅使用令牌流程。一旦客户端宣布支持 elicitation，无需发布此服务的新版本，即可启用额外确认。

锁定的条目

默认情况下，无法修改或删除锁定的时间条目；mite 会返回 423，工具则会返回“locked”错误。force 从不会自动设置，即使 mite 返回 423 也不会。

仅在 admin 模式下，mite_update_time_entry 和 mite_delete_time_entry 还接受 force: true。使用 force: true 调用时始终需要 confirm_token，更新操作也不例外：首次调用（或设置 dry_run: true）会返回预览，指出条目已锁定，并附上令牌；只有使用相同参数、force: true 和该令牌再次调用，才会执行操作。在 read-only 和 write 模式下，该参数不属于输入架构。

计划增加更多工具（更多报告）——请参阅架构决策。

无需技术知识即可安装（Claude Desktop）

1. 从最新版本下载 mite-mcp-server.mcpb。
2. 双击该文件。Claude Desktop 会打开并提示安装扩展。
3. 填写设置并启用扩展：

设置	含义
mite-Account	mite 地址中的名称：对于 https://example.mite.de，请输入 example
API-Key	你的个人 mite API 密钥；Claude Desktop 会安全地存储该密钥，并以掩码形式显示
允许写入时间记录	关闭（默认）：只读。开启：创建、更改和删除时间记录，以及启动和停止计时器
管理主数据	关闭（默认）。开启：管理客户、项目和服务；包括写入时间记录
允许的工具	可选，以逗号分隔的工具名称；留空表示允许所有开关所允许的工具

无需 JSON、无需环境变量，也无需安装 Node.js：Claude Desktop 会使用内置的 Node.js 运行该扩展包。你需要一个已启用 API 访问权限的 mite 账户（在 mite 用户设置中启用），以及从那里获取的 API 密钥。设置使用德语，因为 mite 的用户大多使用德语。

之后更改设置：Claude Desktop → 设置 → 扩展 → mite。更改设置后，只有关闭再重新开启扩展或重启 Claude Desktop 才会生效——在此之前，正在运行的服务会继续使用旧开关。让 Claude 调用 mite_whoami，即可查看服务实际运行的模式。在同一位置还可以单独启用或停用工具——这些设置会叠加在上述开关之上；上述开关决定哪些工具可以存在。

手动设置（Claude Desktop，面向开发者）

要求：Node.js 22 或更高版本、已启用 API 访问权限的 mite 账户（在 mite 用户设置中启用），以及从那里获取的 API 密钥。

将服务添加到 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/），然后重启 Claude Desktop：

{
  "mcpServers": {
    "mite": {
      "command": "npx",
      "args": ["-y", "mite-mcp-server"],
      "env": {
        "MITE_ACCOUNT": "your-account",
        "MITE_API_KEY": "your-api-key"
      }
    }
  }
}

然后，例如可以询问：“显示今年各项目每月的工时和收入。”

配置

变量	必需	含义
MITE_ACCOUNT	是	账户名称——https://<account>.mite.de 的子域名
MITE_API_KEY	是	你的个人 mite API 密钥
MITE_MODE	否	read-only（默认）、write 或 admin
MITE_ALLOW_WRITE	否	true = 模式 write；由扩展包开关设置，是 MITE_MODE 的替代方式
MITE_ALLOW_ADMIN	否	true = 模式 admin；由扩展包开关设置，是 MITE_MODE 的替代方式
MITE_TOOLS	否	以逗号分隔的允许列表，例如 mite_report_projects_by_month

请使用 MITE_MODE 或两个开关；如果同时设置了 MITE_MODE 和值为 true 的开关，服务将拒绝运行。值可为 true/false（也可使用 1/0、yes/no、on/off）。

mite 仍会根据你的密钥角色检查每次调用。服务只能进一步限制权限，不能扩大权限。

开发

npm ci
npm run check   # lint, format, typecheck, tests with coverage, build

请参阅 CONTRIBUTING.md 和架构决策。

License

MIT © Stefan Jacomeit — www.jacomeit.de