🚀 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

从源代码安装

1. 克隆仓库:

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

2. 创建虚拟环境:

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

3. 安装包:

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

开发安装

要设置开发环境:

pip install .[dev]  # 使用开发依赖项安装包

💻 使用示例

基础用法

1. 获取当前时间

# 输入:
# - `timezone`: IANA 时区名称（例如 'America/New_York'）
# 返回:
# - 指定时区的当前时间
# - 时区详细信息
# - 夏令时 (DST) 状态
get_current_time('Europe/London')

2. 转换时间

# 输入:
# - `source_timezone`: 源时区（IANA 格式）
# - `time`: 时间，格式为 HH:MM（24 小时制）
# - `target_timezone`: 目标时区（IANA 格式）
# 返回:
# - 源时间详细信息
# - 目标时间详细信息
# - 时区之间的时差
convert_time('America/New_York', '14:30', 'Europe/Paris')

📚 详细文档

项目详情

依赖项

核心依赖项

• 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

贡献

1. 叉取仓库
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 确保代码通过格式化和测试
4. 提交更改 (git commit -m 'Add some AmazingFeature')
5. 推送到分支 (git push origin feature/AmazingFeature)
6. 打开拉取请求

📄 许可证

本项目采用 MIT 许可证。