Time Zone

🚀 time-mcp

time-mcp 是一个为 Claude AI 提供实时时区时间信息的 Claude 模型配置协议（MCP）服务器。它能助力用户轻松获取不同时区的时间，为 Claude AI 增添强大的时间功能支持。

🚀 快速开始

本项目是一个为Claude AI提供实时时区时间信息的Claude模型配置协议（MCP）服务器。按照以下步骤操作，即可快速使用。

✨ 主要特性

• 精准时间获取：可获取任意 IANA 时区的当前时间。
• 便捷集成：能与 Claude AI 通过 MCP 轻松集成。
• 全面时区支持：借助 Python 的 zoneinfo 模块，实现全面的时区支持。
• 简洁响应格式：以简单的 JSON 响应，按 ISO 格式返回时间信息。

📦 安装指南

# 克隆仓库
git clone https://github.com/yourusername/time-mcp.git
cd time-mcp

# 设置虚拟环境（使用uv）
uv venv
source .venv/bin/activate

# 安装包
pip install -e .

💻 使用示例

基础用法

运行服务器

python -m src.time_mcp.server

这将在本地启动 MCP 服务器，使时间工具可供 Claude 使用。

可用工具

• get_current_time：返回指定时区的当前时间
  • 参数：timezone（字符串） - 任何有效的 IANA 时区（例如，“America/New_York”，“Europe/London”，“Asia/Tokyo”）
  • 默认值：如果没有指定时区，默认为“UTC”

🔧 技术细节

开发

# 运行测试
pytest tests/

# 检查代码风格
ruff check .

# 格式化代码
ruff format .

要求

• Python 3.10+
• MCP 库

📄 许可证

本项目采用 MIT 许可证。