MCP Time Server

基本能力

产品定位

MCP Time Server 是一个时间服务微服务，专注于提供全球时区的时间查询和转换功能。

核心功能

• 当前时间获取：获取任何 IANA 时区的当前时间。
• 时区转换：在不同时区之间转换时间。
• 输入验证：使用 Pydantic 模型进行健壮的输入验证。
• 异步架构：基于 asyncio 构建，确保高效性能。
• 灵活配置：支持通过环境变量和配置文件进行配置。

适用场景

• 需要跨时区显示时间的应用程序。
• 需要处理不同时区时间转换的业务系统。
• 需要高精度时间服务的开发项目。

工具列表

1. 获取当前时间：输入 IANA 时区名称，返回当前时间、时区详情和夏令时状态。
2. 转换时间：输入源时区、时间和目标时区，返回转换后的时间及时间差。

常见问题解答

• 依赖问题：确保安装所有核心依赖（mcp >=1.6.0, pydantic >=2.11.2, PyYAML >=6.0.2, pyz >=0.4.3）。
• 运行问题：确保 Python 版本为 3.11 或更高。

使用教程

使用依赖

1. 确保已安装 Python 3.11 或更高版本。
2. 确保已安装 pip。
3. （可选）建议使用虚拟环境。

安装教程

从 PyPI 安装

pip install chuk-mcp-time-server

从源码安装

1. 克隆仓库：

git clone <repository-url>
cd chuk-mcp-time-server

1. 创建虚拟环境：

python -m venv venv
source venv/bin/activate  # Windows 使用 `venv\Scripts\activate`

1. 安装包：

pip install .  # 以可编辑模式安装

开发安装

pip install .[dev]  # 安装开发依赖

调试方式

运行服务器

chuk-mcp-time-server

程序化使用

from chuk_mcp_time_server.main import main

if __name__ == "__main__":
    main()

运行测试

pytest

许可证

该项目遵循 MIT 开源许可条款。