MCP-NTP 时间服务

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

功能特性

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

安装

需要 Python 3.10 至 3.14；服务固定使用 MCP Python SDK 2.2.0。

# 使用 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