MCP Time Server

MCP Time Server

site icon
2025.04.09 0
Python时间服务时区转换其它
MCP Time Server 是一个基于 Python 的微服务,专门用于提供高级的时间相关功能,包括获取不同时区的当前时间和时区转换。它具有强大的输入验证、异步服务器架构和灵活的配置选项。
View on GitHub

Overview

基本能力

产品定位

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

核心功能

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

适用场景

  • 需要跨时区时间查询的应用。
  • 需要时间转换功能的系统。
  • 需要高精度时间服务的开发项目。

工具列表

  1. Get Current Time:获取指定时区的当前时间,包括时区详情和夏令时状态。
  2. Convert Time:在不同时区之间转换时间,返回源时间和目标时间的详细信息以及时差。

常见问题解答

  • 如何安装:可以通过 PyPI 或从源代码安装。
  • 如何运行:使用命令行接口或通过程序调用。
  • 如何配置:通过环境变量或配置文件进行配置。

使用教程

使用依赖

  • Python 3.11 或更高版本
  • pip
  • (可选)虚拟环境

安装教程

从 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 开源许可条款,请参阅 MIT 了解完整条款。