MCP Time Server

MCP Time Server

概述

MCP Time Server 是一款功能强大的 Python 微服务，旨在提供跨不同时区的高级时间相关实用功能。它支持可靠地获取当前时间，以及在全球各个时区之间转换时间。

项目详情

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

功能

• 获取当前时间：获取任意 IANA 时区的当前时间
• 时区转换：在不同时区之间转换时间
• 全面验证：使用 Pydantic 模型进行可靠的输入验证
• 异步服务架构：基于 asyncio 构建，性能高效
• 灵活配置：可通过环境变量和配置文件进行配置

依赖项

核心依赖项：

• mcp (>=1.6.0)
• pydantic (>=2.11.2)
• PyYAML (>=6.0.2)
• pyz (>=0.4.3)

开发依赖项：

• pytest (>=8.3.5)

安装

前置条件

• Python 3.11 或更高版本
• pip
• （可选）建议使用虚拟环境

从 PyPI 安装

pip install chuk-mcp-artifact-server

从源代码安装

1. 克隆仓库：

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

2. 创建虚拟环境：

python -m venv venv
source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

3. 安装软件包：

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 时区名称（例如，'America/New_York'）

示例：

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')

返回：

• 源时间详情
• 目标时间详情
• 时区之间的时差

开发

代码格式化

• 使用 Black 格式化代码
• 使用 isort 对导入进行排序
• 行长度设为 88 个字符

运行测试

pytest

贡献

1. Fork 仓库
2. 创建功能分支（git checkout -b feature/AmazingFeature）
3. 确保代码通过格式检查和测试
4. 提交更改（git commit -m 'Add some AmazingFeature'）
5. 推送到分支（git push origin feature/AmazingFeature）
6. 发起 Pull Request

许可证

MIT 许可证