时区服务

MCP Time Server是一个基于Python的微服务,提供高级时区相关功能,包括获取当前时间和时区转换。

  • by chrishayuk
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 chrishayuk/chuk-mcp-time-server

使用说明

MCP时间服务器

概述

MCP时间服务器是一个基于Python的复杂微服务,旨在跨不同时区提供高级的时间相关实用程序。它提供了强大的功能,用于检索当前时间和在各种全球时区之间转换时间。

项目详细信息

  • 版本: 0.1.1
  • Python兼容性:Python 3.11+

特性

  • 当前时间检索:获取任何IANA时区的当前时间
  • 时区转换:转换不同时区之间的时间
  • 全面验证:使用Pydantic模型进行稳健的输入验证
  • 异步服务器体系结构:内置asyncio以实现高效性能
  • 灵活的配置:可通过环境变量和配置文件进行配置

依赖项

核心依赖关系:

  • mcp(>=1.6.0)
  • 媒染剂(>=2.11.2)
  • Pyyaml(>=6.0.2)
  • pyz(>=0.4.3)

开发依赖关系:

  • pytest(>=8.3.5)

安装

先决条件

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

从PyPI安装

pip install chuk-mcp-artifact-server

从源代码安装

  1. 克隆存储库:
git clone <repository-url>
cd chuk-mcp-artifact-server
  1. 创建虚拟环境:
python -m venv venv
source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
  1. 安装软件包:
pip install .  # Installs the package in editable mode

开发安装

为发展而设立:

pip install .[dev]  # Installs package with development dependencies

运行服务器

命令行界面

chuk-mcp-artifact-server

程序化使用

from chuk_mcp_artifact_server.main import main

if __name__ == "__main__":
    main()

环境变量

  • NO_BOOTSTRAP:设置为禁用组件引导
  • 其他配置选项可以在配置文件中设置

可用工具

1.获取当前时间

输入:

  • timezone:IANA时区名称(例如,“美国/纽约”)

示例:

get_current_time('Europe/London')

退货:

  • 指定时区的当前时间
  • 时区详细信息
  • 夏令时(DST)状态

2.转换时间

输入:

  • source_timezone:源时区(IANA格式)
  • time:HH:MM(24小时)格式的时间
  • target_timezone:目标时区(IANA格式)

示例:

convert_time('America/New_York', '14:30', 'Europe/Paris')

退货:

  • 源时间详细信息
  • 目标时间详细信息
  • 区域之间的时差

发展

代码格式化

  • 黑色用于代码格式化
  • 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许可证