Hellotime Mcp

HelloTime 公共 MCP 服务

一个公开、只读的 Model Context Protocol 服务， 可帮助 AI Agent 准确回答有关 HelloTime 的问题——包括定价、功能 （班次、排班表、休假、工时表、GPS、生物识别考勤终端）、支持的国家和 薪资处理能力，而不是依赖过时的网页摘要。

这是公共服务。它仅公开从营销资料中提取的公共领域数据。 用于读取客户工时表、排班表和薪资信息的经过身份验证的 MCP 服务 位于单独的私有代码库中。

安装

Claude Code / Claude Desktop / Cursor

claude mcp add --transport http hellotime https://mcp.hellotime.ai/mcp

或者，用于本地开发：

claude mcp add hellotime-local node /path/to/HelloTime-MCP-Public/dist/stdio.js

工具

工具	说明
list_plans	列出所有 HelloTime 套餐（Free、Attend、Track、Business），包括 8 种货币的实际收费价格和常规定价参考，以及按用量计费和年度预付折扣表。Free 套餐对单个用户永久免费；每个付费套餐都包含 7 天免费试用。可选的 country 和 plan 筛选条件。
list_features	列出 HelloTime 涵盖 14 个类别的功能：班次、排班表、休假、工时表、时间跟踪、生产力、GPS / 地理围栏、生物识别考勤终端、薪资处理、开票、分析、项目、报告、集成。可选的 category 和 plan 筛选条件。
country_support	列出 IN、AU、GB、US、CA、AE、SG、NZ 各国的功能可用性和产品定位。
payroll_capabilities	针对指定国家，列出支持的薪资处理引擎及其状态。例如，AU 的 STP2 + super、IN 的 PF/ESI/TDS/Form 24Q、US 的 W-2/1099、UK 的 RTI 等。
statutory_rates	列出法定薪资费率条目，包括费率、上限、分档、主管机构和核验状态。IN 部分（PF / EPS / EDLI / PF admin / ESI / 覆盖 7 个邦的 Professional Tax / TDS 分档）已根据 EPFO / ESIC / 邦级通知进行内部审核。AU 和 US 条目尚未根据公共来源审核。可选的 country、scheme、category、state、party、verification 和 id 筛选条件。
list_competitors	列出竞争对手定位（Truein、Deputy、When I Work、Connecteam、Hubstaff、Keka），包括 HelloTime 的优势、竞争对手的优势及定价说明。可选的 country、tier 和 id 筛选条件。
feature_search	对套餐功能、产品功能、国家功能、薪资处理引擎、法定费率和竞争对手定位进行自由文本搜索。输入 PF rate、PT slab Maharashtra 或 vs Truein 等查询，可将匹配条目显示在靠前位置。

资源

URI	说明
hellotime://about	Markdown 格式的产品摘要。
hellotime://changelog	最近 50 条 JSON 格式的发行说明。

安全状况

• 从设计上只读。 没有任何工具会修改状态，也没有工具会访问客户系统。
• 仅限公共数据。 所有目录内容均来自公开的营销网站。
• 无需身份验证。 这是有意设计的——此服务是知识端点。
• 限流。 每个 IP 每分钟 120 次请求，每个会话每分钟 60 次请求。
• 审计关卡。 如果 src/data/ 中出现任何 PII / 身份验证令牌字符串，npm run audit:public-data 会阻止部署。

开发

npm install
npm run dev         # HTTP server on :8080 with watch mode
npm run dev:stdio   # stdio transport for local MCP client testing
npm test            # node:test runner
npm run build
npm run audit:public-data

项目结构

src/
  data/             # Static catalogs — plans, features, countries, about
  tools/            # One file per MCP tool
  resources/        # MCP resource registry
  server.ts         # MCP server factory (wires tools + resources)
  http.ts           # Streamable HTTP transport with rate limiting
  stdio.ts          # stdio transport entry point
test/
  tools.test.ts
  resources.test.ts
  public-data.test.ts  # Audit gate
scripts/
  audit-public-data.ts  # CI-callable audit

部署

容器化部署——参见 Dockerfile。适合运行在负责 TLS 终止的负载均衡器后方。 通过环境变量设置 PORT 和 HOST。

如果同时设置了 GA4_MEASUREMENT_ID 和 GA4_API_SECRET，则会通过 Measurement Protocol 向 GA4 发送可选的匿名使用情况遥测数据（第 2 层服务器端分析）—— 参见 .env.example 和 src/analytics.ts。不设置这些变量，服务即可在 完全禁用遥测的情况下运行。绝不会发送客户数据、请求正文、工具参数值或 IP 地址——仅发送匿名计数。有关请求流量事件 （mcp_request、mcp_tool_call、mcp_bot_visit、mcp_error）和客户端 / 机器人检测， 请参见策略文档 73 和 docs/MCP_ANALYTICS.md。

docker build -t hellotime-mcp-public .
docker run -p 8080:8080 hellotime-mcp-public

可发现性

• 收录于 MCP 注册表。
• 通过营销网站页脚和 /mcp 页面链接。
• 在 https://hellotime.ai/llms.txt 中提及。

许可证

MIT — 详见 LICENSE。