MCP-NTP 时间服务

这是一个基于MCP（Model Context Protocol）的NTP时间服务，为大模型提供准确的网络时间获取功能。

功能特性

从NTP服务器获取准确的网络时间
支持stdio和sse两种传输模式
提供get_current_time工具，方便大模型获取当前时间
支持环境变量和请求头两种配置NTP服务器的方式
返回详细的时间信息和NTP协议数据

Related MCP server: Time Tools MCP Server

安装

# 使用 uv 安装依赖 uv sync

配置

环境变量配置（stdio模式）

设置NTP_DOMAIN_URL环境变量：

export NTP_DOMAIN_URL="ntp.aliyun.com"

请求头配置（sse模式）

在请求头中包含ntp_url字段：

ntp_url: ntp.aliyun.com

使用方法

stdio模式

# 设置环境变量 export NTP_DOMAIN_URL="ntp.aliyun.com" # 启动服务 python -m app

sse模式

# 启动服务 python -m app --transport sse --port 8080 # 使用curl测试 curl -H "ntp_url: ntp.aliyun.com" http://localhost:8080/sse

工具说明

get_current_time

获取当前NTP服务器时间。

参数：

ntp_server (可选): NTP服务器地址，如果不提供则使用环境变量或请求头中的配置

返回数据：

{ "ntp_server": "ntp.aliyun.com", "ntp_timestamp": 1703123456.789, "ntp_time": "2023-12-21T10:30:56.789", "local_system_time": "2023-12-21T10:30:56.789", "time_offset": 0.123, "response_delay": 0.045 }

调试

可以使用提供的测试NTP服务器进行调试：

export NTP_DOMAIN_URL="ntp.aliyun.com" python -m app -v

开发

项目结构

mcp-ntp/ ├── app/ │ ├── __init__.py # 主入口 │ ├── server.py # MCP服务器实现 │ ├── client.py # NTP客户端 │ └── config.py # 配置管理 ├── pyproject.toml # 项目配置 └── README.md # 说明文档

添加新的NTP服务器

在client.py中的get_current_time函数可以轻松扩展支持更多NTP服务器配置。

许可证

MIT License

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

MCP-NTP Time Service