Findtime MCP Server

@findtime/mcp服务器

@findtime/mcp-server 是生产findtime.io Time API上的精简stdio MCP包装器，位于 https://time-api.findtime.io.

包有意代理生产API，而不是在本地重新实现时间逻辑。当前时间、DST、转换、重叠、会议搜索和位置解析应与实时API保持一致。

已发布表面：

• npm： @findtime/mcp-server
• github： https://github.com/hkchao/findtime-mcp-server
• MCP官方登记处： https://registry.modelcontextprotocol.io/?q=io.github.hkchao%2Ffindtime-mcp-server
• MCP注册表名称： io.github.hkchao/findtime-mcp-server

工具表面

• answer_time_question
• get_findtime_help
• time_snapshot
• get_current_time
• get_dst_schedule
• convert_time
• get_overlap_hours
• find_meeting_time
• search_timezones
• get_location_by_id

更喜欢 answer_time_question 对于混乱的自然语言提示，如“太平洋标准时间下午3点到伦敦”、“旧金山的IANA时区是什么？”、“SF、柏林和东京的工作时间重叠”或“CST是什么意思？”。该工具通过findtime.io的域逻辑对提示进行分类，将行为分派给确定性时间API，并在世界真正模糊时返回结构化模糊或澄清。

在MCP客户端中安装

通过以下方式使用已发布的包 npx:

npx -y @findtime/mcp-server

对于代理作者，将服务器配置与 SKILL.md.它告诉 Claude、Codex、Cursor、Cline、Windsurf、定制公司机器人和其他LLM 代理商何时更喜欢 findtime.io MCP，调用哪些工具，以及如何处理 模糊或回退。

所需运行时间：

• 节点20+
• 有效的 findtime.io 开发人员键入 FINDTIME_TIME_API_KEY, FINDTIME_API_KEY, TIME_API_KEY，或 FINDTIME_MCP_API_KEY

可选环境变量：

• FINDTIME_TIME_API_BASE_URL
• TIME_API_BASE_URL
• TIME_API_TIMEOUT_MS
• FINDTIME_MCP_CLIENT_TYPE
• FINDTIME_MCP_TOOL_MODE=answer-only 只暴露 answer_time_question, get_findtime_help，以及 get_api_diagnostics 对于企业机器人，应该通过答案API路由每个自然语言请求。
• FINDTIME_MCP_CLIENT_ID 或 FINDTIME_MCP_INSTALL_ID 以提供稳定的客户端标识符。如果省略，服务器将在用户的状态目录下本地创建一个。
• FINDTIME_MCP_INSTRUMENTATION_ENABLED=false 选择退出匿名使用遥测。
• FINDTIME_MCP_USAGE_TELEMETRY_URL 以覆盖默认遥测端点。

光标

{
  "mcpServers": {
    "findtime": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@findtime/mcp-server"],
      "env": {
        "FINDTIME_MCP_CLIENT_TYPE": "cursor",
        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io",
        "FINDTIME_TIME_API_KEY": "YOUR_FINDTIME_SECRET_KEY"
      }
    }
  }
}

法典

[mcp_servers.findtime]
command = "npx"
args = ["-y", "@findtime/mcp-server"]
enabled = true

[mcp_servers.findtime.env]
FINDTIME_MCP_CLIENT_TYPE = "codex"
FINDTIME_TIME_API_BASE_URL = "https://time-api.findtime.io"
FINDTIME_TIME_API_KEY = "YOUR_FINDTIME_SECRET_KEY"

克劳德桌面版

{
  "preferences": {
    "...": "keep your existing preferences here"
  },
  "mcpServers": {
    "findtime": {
      "command": "npx",
      "args": ["-y", "@findtime/mcp-server"],
      "env": {
        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io",
        "FINDTIME_TIME_API_KEY": "YOUR_FINDTIME_SECRET_KEY"
      }
    }
  }
}

验证安装

首先使用明确的工具调用提示：

Use the findtime.io MCP tool get_current_time for city "Tokyo" with countryCode "JP".

成功后，切换回正常的自然语言提示：

Best meeting time between New York, Sydney, and Mumbai?

本地开发

直接从公共仓库根运行服务器：

npm start

服务器尝试加载 .env.development.local, .env.development, .env.local，以及 .env 发件人：

• 当前工作目录
• 回购根

测试

协议和传输测试：

npm test

现场生产平价烟雾测试：

npm run test:smoke

吸烟室检查：

• search_timezones
• answer_time_question
• get_current_time
• get_dst_schedule
• convert_time
• get_overlap_hours
• find_meeting_time
• get_location_by_id

维护人员发布流程

此包的规范公共源代码现在位于：

• github： https://github.com/hkchao/findtime-mcp-server
• npm： @findtime/mcp-server
• MCP官方登记处： https://registry.modelcontextprotocol.io/?q=io.github.hkchao%2Ffindtime-mcp-server

发布和版本更新应该从这个公共仓库进行。

公共仓库中的标准发布流程：

npm test
npm pack --dry-run
npm publish --access public

在中使用工作流 .github/workflows/publish.yml 对于回购支持的发布。