Time Server

Time Server

site icon
2025.03.24 0
Python时间服务时区转换其它
clssck_mcp-time-server 是一个基于 Model Context Protocol (MCP) 标准构建的时间服务器,专注于时区转换和时间相关操作。它提供了 RESTful API 端点,支持获取特定时区的当前时间、在不同时区之间转换时间等功能。该服务器采用类型安全的 Python 实现,并集成了时区数据库,具有全面的错误处理机制。
View on GitHub

Overview

基本能力

产品定位

clssck_mcp-time-server 是一个时间服务工具,专注于时区转换和时间相关操作。

核心功能

  • 获取任何时区的当前时间
  • 在不同时区之间转换时间
  • 基于 MCP 协议标准构建
  • 类型安全的 Python 实现
  • RESTful API 端点
  • 全面的错误处理
  • 时区数据库集成

适用场景

  • 需要处理多时区时间的应用程序
  • 需要显示不同地区当前时间的系统
  • 需要转换时间戳时区的服务
  • 开发跨时区协作工具

工具列表

  1. get_current_time
  2. 能力:获取特定时区的当前时间
  3. 参数:timezone - IANA 时区标识符(如 "America/New_York")
  4. 返回:ISO 8601 格式的当前时间

  5. convert_time

  6. 能力:在不同时区之间转换时间
  7. 参数:
    • time - 要转换的时间(ISO 8601 格式)
    • from_timezone - 源时区
    • to_timezone - 目标时区
  8. 返回:ISO 8601 格式的转换后时间

常见问题解答

  • 安装问题:确保使用 Python 3.10+ 版本
  • 运行时问题:检查时区标识符是否正确(使用 IANA 标准)
  • 开发问题:安装开发依赖时使用 pip install -e .[dev]

使用教程

使用依赖

  • Python 3.10 或更高版本

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @clssck/mcp-time-server --client claude

手动安装

pip install .

调试方式

  1. 启动服务器
python -m time_server
  1. 运行测试
pytest
  1. 检查代码质量
ruff check .
mypy src

许可证

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