时区时间服务

一个基于Cloudflare Workers的MCP服务器,提供时区感知的时间信息。

  • by kiyo-e
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 kiyo-e/time-mcp

使用说明

mcp时间工作者

基于Cloudflare Workers的MCP(模型上下文协议)服务器,提供时区感知时间信息。

特性

  • 返回任何IANA时区的当前日期和时间
  • 在Cloudflare的全球边缘网络上运行
  • 实现AI代理集成的模型上下文协议
  • 通过环境变量配置默认时区
  • ISO 8601兼容的时间格式,带UTC偏移

先决条件

  • Node.js 18或更高版本
  • Cloudflare帐户(用于部署)
  • Wrangler CLI(通过npm安装)

安装

npm install

发展

启动本地开发服务器:

npm run dev

MCP服务器将在本地可用,以便与MCP客户端进行测试。

部署

部署到Cloudflare Workers:

npm run deploy

自定义时区配置

在部署过程中覆盖默认时区:

wrangler deploy --var DEFAULT_TIMEZONE:America/New_York

或者在Cloudflare仪表板的Workers>Settings>Environment Variables下设置它。

用法

此MCP服务器公开了一个可由任何MCP客户端调用的工具:

工具: get_time

返回指定时区的当前日期和时间。

参数:

  • timezone (可选):IANA时区标识符(例如,“亚洲/东京”、“美洲/纽约”、“欧洲/伦敦”)
    • 如果没有提供,请使用 DEFAULT_TIMEZONE 环境变量
    • 最后的退路:“亚洲/东京”

响应格式:

YYYY-MM-DDTHH:MM:SS±HH:MM

例子: 2025-11-27T15:30:45+09:00

MCP客户端配置示例

添加到您的MCP客户端配置中(例如,Claude Desktop):

{
  "mcpServers": {
    "time": {
      "url": "https://your-worker.your-subdomain.workers.dev"
    }
  }
}

配置

牧马人.汤姆

默认时区在中配置 wrangler.toml:

[vars]
DEFAULT_TIMEZONE = "Asia/Tokyo"

修改此值以更改部署的默认时区。

技术细节

  • 运行时:Cloudflare Workers(边缘)
  • 协议:模型上下文协议(MCP)
  • 时区库:本地 Intl.DateTimeFormat API
  • 验证:Zod模式验证
  • 跨域资源共享:启用通配符来源(*)

许可证

MIT许可证-请参阅 许可证 详细信息文件