用途
time-node-mcp 是一个 Model Context Protocol (MCP) 服务器，专门提供时区感知的日期和时间操作。它解决的核心问题是：AI 助手常常因为时区混淆而返回错误的日期信息。通过该服务器，AI 助手可以获取准确的、基于指定时区的日期和时间数据。
主要能力
- 准确的时区处理：获取任意 IANA 时区的当前时间。
- 时间转换：在不同时区之间转换时间。
- 多种格式：支持 ISO 8601、本地化以及人类可读的格式。
- 系统时区检测：自动检测系统时区。
- 夏令时感知：正确处理夏令时（DST）转换。
- 日期工具：获取当前日期及对应的星期信息。
可用工具
服务器提供四个工具：
-
get_current_time：获取指定时区的当前日期和时间。
timezone（必填）：IANA 时区标识符（例如 "America/New_York"、"Europe/London"）。format（可选）：输出格式，可选 "iso"、"local" 或 "full"，默认 "iso"。
-
convert_time：将时间从一个时区转换到另一个时区。
sourceTimezone（必填）：源 IANA 时区标识符。targetTimezone（必填）：目标 IANA 时区标识符。time（必填）：HH:MM 或 HH:MM:SS 格式（24 小时制）。date（可选）：YYYY-MM-DD 格式，未提供时使用当前日期。
-
get_system_timezone：获取系统当前时区及当前时间信息。无参数。
-
get_current_date：获取指定时区的当前日期及星期信息。
timezone（必填）：IANA 时区标识符。includeTime（可选）：是否包含时间信息，默认 false。
使用方式
环境要求
- Node.js 18.0.0 或更高版本。
安装与构建
资料中提供了安装与构建步骤，但具体命令未在提供内容中完整列出。通常需要克隆仓库并运行 npm run build。
与 Claude Desktop 配合使用
将以下配置添加到 Claude Desktop 的设置文件中：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - Windows：
%APPDATA%\Claude\claude_desktop_config.json
需要将 /path/to/time-node-mcp/ 替换为实际安装目录的路径。
适用场景
- 准确的当前日期/时间：当 Claude 需要知道用户所在时区的“今天是什么日子”时。
- 会议安排：在不同时区之间转换会议时间。
- 旅行规划：旅行时了解时差。
- 国际协作：与跨多个时区的团队合作。
时区支持
该服务器支持所有 IANA 时区标识符，包括但不限于：
- America/New_York
- Australia/Sydney
- Pacific/Auckland
完整列表可在 IANA 时区数据库中找到。
错误处理
服务器对以下情况提供全面的错误处理，并以结构化 JSON 格式返回描述性错误信息：
- 无效的时区标识符
- 格式错误的时间格式
- 无效的日期格式
限制与注意事项
- 需要 Node.js 18.0.0 或更高版本。
- 服务器使用系统当前日期/时间作为基准，因此需要确保系统时钟正确且时区设置无误。
- 使用有效的 IANA 时区标识符，注意大小写（例如 "America/New_York" 而非 "america/new_york"）。
- 如果 MCP 服务器无法连接，需验证 Claude Desktop 配置中的路径是否正确，并确保项目已构建（
npm run build）且 Node.js 已安装并可访问。 - 采用 MIT 许可证。
