时间 MCP 服务器

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

可用工具

• 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 设置中添加以下内容：

"mcpServers": {
  "time": {
    "command": "uvx",
    "args": ["time-mcp-local"]
  }
}

"mcpServers": {
  "time": {
    "command": "python",
    "args": ["-m", "time_mcp_local"]
  }
}

配置用于 Zed

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

"context_servers": [
  "mcp-server-time": {
    "command": "uvx",
    "args": ["time-mcp-local"]
  }
}

"context_servers": {
  "mcp-server-time": {
    "command": "python",
    "args": ["-m", "time_mcp_local"]
  }
}

自定义设置

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

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