日期时间工具服务

一个轻量级的MCP服务器,通过stdio传输提供主机操作系统的日期和时间工具。

  • by joshuaboys
  • TypeScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 joshuaboys/datetime-mcp

使用说明

日期时间mcp

轻量级的 主控程序 通过stdio传输将主机操作系统时钟作为日期/时间工具公开的服务器。

快速开始

npx datetime-mcp

或全局安装:

npm install -g datetime-mcp

工具

datetime.now

从主机操作系统时钟返回当前日期/时间。

参数 必填 说明
tz 否 IANA时区(例如。 America/New_York)
{
  "tz": "Australia/Perth",
  "utcIso": "2026-01-22T03:30:00.000Z",
  "epochMs": 1737516600000,
  "human": "Thu, 22 Jan 2026, 11:30:00 AWST"
}

datetime.parse

解析日期/时间字符串并返回规范形式。

参数 必填 说明
value yes JS可解析的日期/时间字符串 Date
tz no 人类可读输出的IANA时区
{
  "input": "2026-01-22",
  "tz": "Australia/Perth",
  "utcIso": "2026-01-22T00:00:00.000Z",
  "epochMs": 1737504000000,
  "human": "Thu, 22 Jan 2026, 08:00:00 AWST"
}

datetime.health

返回服务器健康指标,包括单调时间(不会随着NTP调整而跳跃)。

{
  "wallEpochMs": 1737516600000,
  "monotonicMs": 12345678,
  "processUptimeMs": 5000
}

配置

克劳德代码

增添 ~/.claude/settings.json 或项目 .mcp.json:

{
  "mcpServers": {
    "datetime": {
      "command": "npx",
      "args": ["-y", "datetime-mcp"],
      "env": {
        "MCP_TZ": "Australia/Perth"
      }
    }
  }
}

克劳德桌面版

添加到您的Claude Desktop MCP配置中:

{
  "mcpServers": {
    "datetime": {
      "command": "npx",
      "args": ["-y", "datetime-mcp"],
      "env": {
        "MCP_TZ": "Australia/Perth"
      }
    }
  }
}

环境变量

变量 默认值 描述
MCP_TZ Australia/Perth 默认IANA时区

发展

pnpm install
pnpm dev       # run with tsx (hot reload)
pnpm build     # compile TypeScript
pnpm start     # run compiled output

许可证

麻省理工学院