Time and Timezone

🚀 时间 MCP 服务器

时间 MCP 服务器是一个提供时间和时区转换功能的模型上下文协议（MCP）服务器。它能让大型语言模型（LLMs）获取当前时间信息，使用 IANA 时区名称进行时区转换，还能自动检测系统时区。

✨ 主要特性

• 提供 get_current_time 和 convert_time 两个工具，满足获取当前时间和时区转换的需求。
• 支持自动检测系统时区，也可手动指定时区。
• 可在不同应用（如 Claude.app、Zed）中进行配置使用。

可用工具

• get_current_time - 获取特定时区或系统时区的当前时间。
  • 必填参数：
    • timezone (字符串)：IANA 时区名称（例如 'America/New_York', 'Europe/London'）
• convert_time - 在不同时区之间转换时间。
  • 必填参数：
    • source_timezone (字符串)：源 IANA 时区名称
    • time (字符串)：24 小时制时间格式（HH:MM）
    • target_timezone (字符串)：目标 IANA 时区名称

📦 安装指南

使用 uv（推荐）

当使用 uv 时，无需进行任何特定安装。我们将直接使用 uvx 运行 mcp-server-time。

使用 pip 安装

或者，您可以通过 pip 安装 time-mcp-local：

pip install time-mcp-local

安装完成后，您可以使用以下命令运行它作为脚本：

python -m time-mcp-local

📚 详细文档

配置指南

配置用于 Claude.app

在您的 Claude 设置中添加以下内容：

配置用于 Zed

在您的 Zed settings.json 中添加以下内容：

自定义设置

默认情况下，此服务器会自动检测系统时区。如果需要覆盖默认行为，您可以通过以下命令指定时区：

uv run --env TZ=Asia/Shanghai time-mcp-local

示例交互

获取当前时间

请求：

{
  "id": "123",
  "procedure": {
    "fn_ref": "get_current_time"
  }
}

响应：

{
  "id": "123",
  "result": {
    "time": "当前时间",
    "timestamp": "Unix 时间戳"
  }
}

转换时间

请求：

{
  "id": "456",
  "procedure": {
    "fn_ref": "convert_time",
    "args": ["source_timezone", "target_timezone"]
  }
}

响应：

{
  "id": "456",
  "result": {
    "converted_time": "转换后的时间"
  }
}

调试

要调试服务器，请使用以下命令：

uv run time-mcp-local --inspect

构建和发布

要构建和发布包，请运行以下命令：

uv build --wheel
uv publish --token xxx