用途
mcp-simple-timeserver 是一个简单的 MCP（Model Context Protocol）服务器，旨在解决 Claude 在 claude.ai 中无法获知消息时间戳或当前时间的问题。通过该服务器，Claude 可以获取当前时间、了解节假日、计算日期之间的时间距离等。
主要能力
该服务器提供以下工具：
- get_current_time：支持位置参数（timezone > city > country 优先级）获取世界任何地方的当地时间，返回本地时间、时区信息、UTC 偏移和夏令时状态。如果当天是公共假日，会显示在输出中。还可接受可选的 calendar 参数，传入逗号分隔的日历格式列表，例如
get_current_time(city="Tokyo", calendar="japanese")返回东京当地时间及日本年号日历。 - calculate_time_distance：计算两个日期或时间之间的时长。可使用位置参数（city、country、timezone）指定时区上下文。当
business_days=true时，忽略具体时间，将日期视为完整天数（包含端点），此时 unit 参数被忽略。仅当假日落在工作日时才会被排除。示例：calculate_time_distance(from_date="now", to_date="2025-12-31")返回新年倒计时；calculate_time_distance(from_date="2026-01-26", to_date="2026-01-30", business_days=true, exclude_holidays=true, city="Sydney")返回该范围内的营业日数。 - get_holidays 和 is_holiday：获取约 119 个国家的公共假日和学校假日信息。当 is_holiday 使用 city 参数时，学校假日会过滤为仅显示影响特定区域的假日，适用于学校假日因地区而异的国家（如波兰省份、德国联邦州、西班牙自治区）。示例：
is_holiday(city="Warsaw", date="2026-01-19")返回马佐夫舍省特定的学校假日信息。
所有工具（除 get_local_time 外）使用来自 NTP 服务器的准确时间。如果 NTP 不可用，它们会优雅地回退到本地服务器时间并给出提示。
使用方式
可通过 Smithery 自动安装到 Claude Desktop，或手动安装：首先使用命令安装模块，然后在 MCP 客户端（如 Claude 桌面应用）中配置。Mac OS 和 Windows 的配置路径不同，Windows 需使用 where python 检查 Python 可执行文件路径。典型配置如下所示。该项目还包含一个可网络托管的版本，可作为独立 Web 服务器部署，详见 Web 服务器部署指南。也可以直接将 https://mcp.andybrandt.net/timeserver 添加到 Claude 和其他支持 MCP 的工具中使用。
适用场景
适用于需要让 Claude 感知时间、查询节假日、计算日期差等场景，尤其在跨时区、涉及公共假日或学校假日的日期计算中。
限制
- 公共假日数据来自 Nager.Date API（119 个国家），学校假日数据来自 OpenHolidaysAPI（36 个国家，主要在欧洲）。
- 学校假日按区域过滤仅在提供 city 参数时生效，且覆盖范围有限。
- 若 NTP 不可用，时间精度会回退到本地服务器时间。
- 具体安装命令和配置示例需参考官方仓库文档。
