使用说明
MCP简单时间服务器
Anthropic做出的一个奇怪的设计决定是，剥夺了Claude在Claude.ai中发送的消息的时间戳或一般的当前时间。可怜的克劳德不知道现在几点了！ mcp-simple-timeserver 是一个简单的MCP服务器，可以修复这个问题。
可用工具
此服务器提供以下工具：
| 工具 | 说明 |
|---|---|
get_local_time |
从用户的计算机返回当前本地时间、星期几和时区 |
get_utc |
从返回精确的UTC时间 NTP时间服务器 |
get_current_time |
通过可选的位置、时区和日历转换返回当前时间 |
calculate_time_distance |
计算两个日期/时间之间的持续时间（倒计时、经过的时间） |
get_holidays |
返回一个国家的公共假期（以及可选的学校假期） |
is_holiday |
检查特定日期是否为特定国家或城市的假日 |
所有工具（除 get_local_time)使用NTP服务器的准确时间。如果NTP不可用，它们会优雅地回退到本地服务器时间并发出通知。
位置支持通过 get_current_time
这 get_current_time 该工具支持位置参数，以获取世界任何地方的本地时间：
| 参数 | 说明 | 示例 |
|---|---|---|
city |
城市名称（主要用例） | "Warsaw", "Tokyo", "New York" |
country |
国家名称或ISO代码 | "Poland", "JP", "United States" |
timezone |
IANA时区或UTC偏移 | "Europe/Warsaw", "+05:30" |
优先： timezone > city > country当提供位置时，响应包括本地时间、时区信息、UTC偏移和DST状态。
如果今天是指定地点的公共假日，它将显示在输出中。
日历支持通过 get_current_time
这 get_current_time 该工具还接受可选 calendar 带有逗号分隔的日历格式列表的参数：
| 日历 | 说明 |
|---|---|
unix |
Unix时间戳（自1970-01-01以来的秒数） |
isodate |
ISO 8601周日期（例如。， 2026-W03-6) |
hijri |
伊斯兰/回历阴历 |
japanese |
日本时代日历（返回英语和汉字） |
hebrew |
希伯来/犹太日历（返回英语和希伯来语，包括节假日） |
persian |
波斯语/贾拉利历（返回英语和波斯语） |
例子： get_current_time(city="Tokyo", calendar="japanese") 使用日本纪元日历返回东京当地时间。
通过以下方式计算时间距离 calculate_time_distance
计算两个日期或时间之间的持续时间：
| 参数 | 说明 | 示例 |
|---|---|---|
from_date |
开始日期（ISO 8601或“现在”） | "2025-01-15", "now" |
to_date |
结束日期（ISO 8601或“现在”） | "2025-12-31", "2025-06-01T17:00:00" |
unit |
输出格式 | "auto", "days", "weeks", "hours", "minutes", "seconds" |
business_days |
仅计算周一至周五（包括首尾两天） | true |
exclude_holidays |
也不包括公共假日（需要国家/城市） | true |
位置参数(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个国家的公共假期和学校假期信息：
get_holidays 参数：
| 参数 | 说明 | 示例 |
|---|---|---|
country |
国家名称或ISO代码（必填） | "Poland", "DE", "United States" |
year |
获得假期的年份（默认值：当前年份） | 2026 |
include_school_holidays |
包括学校假期 | true |
is_holiday 参数：
| 参数 | 说明 | 示例 |
|---|---|---|
country |
国家名称或ISO代码 | "Poland", "US" |
city |
特定地区信息的城市名称 | "Warsaw", "Munich" |
date |
以ISO格式检查的日期（默认值：今天） | "2026-01-01" |
地区学校假期：使用时 city 参数与 is_holiday，学校假期会被过滤，只显示影响特定地区的假期。这在学校假期因地区而异的国家特别有用（例如，波兰省、德国联邦州、西班牙自治区）。
例子： is_holiday(city="Warsaw", date="2026-01-19") 返回马佐夫舍省特有的学校假期信息。
数据源:
- 公众假期： 纳格。API日期 （119个国家）
- 学校假期： OpenHolidaysAPI （36个国家，主要是欧洲国家）
安装
通过Smithery安装
通过以下方式自动安装克劳德桌面的Simple Timeserver 铁匠铺:
npx -y @smithery/cli install mcp-simple-timeserver --client claude
手动安装
首先使用以下方法安装模块：
pip install mcp-simple-timeserver
然后在MCP客户端中配置 Claude桌面应用程序.
在Mac OS下，它看起来像这样：
"mcpServers": {
"simple-timeserver": {
"command": "python",
"args": ["-m", "mcp_simple_timeserver"]
}
}
在Windows下，您必须使用以下命令检查Python可执行文件的路径 where python 在 cmd （Windows命令行）。
典型的配置如下：
"mcpServers": {
"simple-timeserver": {
"command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
"args": ["-m", "mcp_simple_timeserver"]
}
}
Web服务器变体
该项目还包括一个可作为独立web服务器部署的网络托管版本。有关如何运行和部署它的说明，请参阅 Web服务器部署指南.
或者，您可以简单地通过将其添加到以下位置来使用我的服务器https://mcp.andybrandt.net/timeserverClaude和其他支持MCP的工具。