AI导哈

日期时间工具MCP

一个用于日期时间操作和时区转换的模型上下文协议（MCP）服务器，可作为需要标准化日期时间操作的应用或代理的后端工具。

  • by abhi12299
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 abhi12299/date-time-tools

使用说明

日期时间工具MCP

用于日期时间操作和时区转换的模型上下文协议（MCP）服务器。

概述

此MCP服务器提供了一组用于处理日期时间字符串的工具，包括时区转换、日期变异（算术）以及获取当前日期时间和时区。它被设计为需要健壮、标准化日期时间操作的应用程序或代理的后端实用程序。

实时部署： https://date-time-tools.iabhishek.workers.dev/mcp

建筑

此服务器运行在 Cloudflare员工 并使用 可流式传输的HTTP 传输（还暴露了遗留的SSE端点）。每个会话状态由Cloudflare的持久对象支持 agents McpAgent 包装。

终点：

  • POST/GET/DELETE /mcp --可流式HTTP传输。通过跟踪会话 mcp-session-id 头球
  • GET /sse, POST /sse/message --面向老客户的传统SSE传输。

本地开发

npm install
npm run dev   # wrangler dev — serves at http://127.0.0.1:8787/mcp

部署到Cloudflare

手册

一次性设置：

npx wrangler login

部署：

npm run deploy

Wrangler打印公共URL——对于这个项目，它是 https://date-time-tools.iabhishek.workers.dev/mcpWorkers Free计划涵盖了此服务器（每天10万个请求；Durable Objects免费层涵盖了会话存储）。

自动化（GitHub操作）

.github/workflows/deploy.yml 每次推送时都会部署 main （和手动 workflow_dispatch).配置两个存储库机密：

与MCP客户端集成

克劳德代码

claude mcp add date-time-tools --transport http https://date-time-tools.iabhishek.workers.dev/mcp

添加 --scope user 为每个项目注册，或 --scope project 承诺a .mcp.json 与合作者分享。证实 claude mcp list；在Claude Code中，运行 /mcp 检查状态和工具。

通用流式HTTP客户端

配置支持Streamable HTTP传输的客户端，使其指向已部署的URL：

{
  "mcpServers": {
    "date-time-tools": {
      "url": "https://date-time-tools.iabhishek.workers.dev/mcp"
    }
  }
}

对于只会说stdio的客户，请与 mcp-remote:

{
  "mcpServers": {
    "date-time-tools": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://date-time-tools.iabhishek.workers.dev/mcp"]
    }
  }
}

可用工具

此MCP服务器为LLM提供以下工具：

  • convertTimezones：将日期时间字符串从一个时区转换为另一个时区。
  • mutateDate：从日期时间字符串中添加或减去天、小时、分钟、月或年。
  • currentDateTimeAndTimezone：获取当前日期、时间和时区。

🧪 MCP检验员测试

跑 npm run dev，然后在另一个终端中：

npx -y @modelcontextprotocol/inspector

选择 可流式传输的HTTP 运输和使用 http://127.0.0.1:8787/mcp 作为URL。

特性

  • 时区转换
    使用Luxon兼容格式将日期时间字符串从一个IANA时区转换为另一个时区。

  • 日期突变
    从日期时间字符串中添加或减去天、小时、分钟、月或年。

  • 当前日期时间和时区
    检索用户/系统的当前日期、时间和时区。

相关 MCP