🚀 MCP 时间服务器
MCP 时间服务器是一款功能强大的 Python 微服务，它提供了高级的时间相关实用工具，支持多种时区。借助该服务，用户能够轻松获取当前时间，并在不同的全球时区之间进行时间转换。
🚀 快速开始
运行服务器
命令行界面
chuk-mcp-time-server
编程式使用
from chuk_mcp_time_server.main import main
if __name__ == "__main__":
main()
✨ 主要特性
- 当前时间获取：可获取任意 IANA 时区的当前时间。
- 时区转换：支持在不同的时区之间进行时间转换。
- 全面验证：使用 Pydantic 模型进行强大的输入验证。
- 异步服务器架构：采用 asyncio 实现高效性能。
- 灵活配置：可通过环境变量和配置文件进行配置。
📦 安装指南
先决条件
- Python 3.11 或更高版本
- pip
- （可选）推荐使用虚拟环境
从 PyPI 安装
pip install chuk-mcp-time-server
从源代码安装
- 克隆仓库:
git clone
cd chuk-mcp-time-server
- 创建虚拟环境:
python -m venv venv
source venv/bin/activate # 在 Windows 上使用 `venv\Scripts\activate`
- 安装包:
pip install . # 以可编辑模式安装包
开发安装
要进行开发设置:
pip install .[dev] # 安装带开发依赖的包
💻 使用示例
基础用法
1. 获取当前时间
get_current_time('Europe/London')
此代码用于获取欧洲伦敦时区的当前时间，输入为 IANA 时区名称（例如，'America/New_York'），返回指定时区的当前时间、时区详细信息以及夏令时 (DST) 状态。
2. 转换时间
convert_time('America/New_York', '14:30', 'Europe/Paris')
该代码用于将美国纽约时区的 14:30 转换为欧洲巴黎时区的时间，输入包括源时区（IANA 格式）、时间（格式为 HH:MM，24 小时制）和目标时区（IANA 格式），返回源时间详细信息、目标时间详细信息以及两个时区之间的时差。
📚 详细文档
项目详情
| 属性 | 详情 |
|---|---|
| 版本 | 0.1.1 |
| Python 兼容性 | Python 3.11+ |
依赖项
核心依赖
- mcp (>=1.6.0)
- pydantic (>=2.11.2)
- PyYAML (>=6.0.2)
- pyz (>=0.4.3)
开发依赖
- pytest (>=8.3.5)
环境变量
NO_BOOTSTRAP：设置此变量可禁用组件启动引导，其他配置选项可通过配置文件设置。
🔧 技术细节
代码格式化
- 使用 Black 进行代码格式化。
- 使用 isort 进行导入排序。
- 设置行长限制为 88 字符。
运行测试
pytest
🤝 贡献
- 叉克隆仓库。
- 创建功能分支 (
git checkout -b feature/AmazingFeature)。 - 确保代码通过格式检查和测试。
- 提交更改 (
git commit -m 'Add some AmazingFeature')。 - 推送到分支 (
git push origin feature/AmazingFeature)。 - 打开 Pull Request。
📄 许可证
MIT License