clssck_mcp-time-server

🚀 时间服务器

这是一个基于模型上下文协议标准的MCP服务器，使用Python编写，可进行时区转换和时间相关操作，为用户提供便捷的时间处理服务。

🚀 快速开始

启动服务器，可使用以下命令：

python -m time_server

✨ 主要特性

• 时区时间获取：获取特定时区的当前时间。
• 时区时间转换：在不同时区之间转换时间。
• 协议标准构建：基于MCP协议标准构建。
• 类型安全实现：采用类型安全的Python实现。
• RESTful端点：提供RESTful API端点。
• 错误全面处理：具备全面的错误处理机制。
• 时区库集成：集成了时区数据库。

📦 安装指南

使用Smithery安装

通过Smithery自动安装Claude桌面的时间服务器：

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

手动安装

pip install .

💻 使用示例

基础用法

启动服务器：

python -m time_server

高级用法

在开发过程中，可进行以下操作： 安装开发依赖：

pip install -e .[dev]

运行测试：

pytest

检查代码质量：

ruff check .
mypy src

📚 详细文档

API文档

工具

get_current_time

获取特定时区的当前时间。 参数：

• timezone：字符串 - IANA时区标识符（例如“America/New_York”） 返回：
• 按ISO 8601格式表示的当前时间

convert_time

在不同时区之间转换时间。 参数：

• time：字符串 - 要转换的时间，按ISO 8601格式表示
• from_timezone：字符串 - 源时区
• to_timezone：字符串 - 目标时区 返回：
• 按ISO 8601格式表示的转换后时间

🔧 技术细节

本项目使用Python开发，基于MCP协议标准构建，实现了类型安全的代码。通过集成时区数据库，能够准确地进行时区转换和时间相关操作。同时，提供了RESTful API端点，并进行了全面的错误处理，确保系统的稳定性和可靠性。

🤝 贡献指南

本项目遵循Contributor Covenant的行为准则。参与时，您需遵守此准则。

📄 许可证

本项目采用MIT许可证。