Skip to main content
Glama
deenesjakoruzh
lchinglen

Time MCP Server

by lchinglen
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Time MCP Server

一个提供时间和时区转换能力的 Model Context Protocol 服务器。该服务器使 LLM 能够获取当前时间信息，并使用 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。

uvx mcp-server-time

使用 PIP

或者，你可以通过 pip 安装 mcp-server-time：

pip install mcp-server-time

安装后，你可以使用以下命令将其作为脚本运行：

python -m mcp_server_time

Related MCP server: Time MCP Server

配置

为 Claude.app 配置

添加到你的 Claude 设置中：

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time"]
    }
  }
}
{
  "mcpServers": {
    "time": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "LOCAL_TIMEZONE", "mcp/time"]
    }
  }
}
{
  "mcpServers": {
    "time": {
      "command": "python",
      "args": ["-m", "mcp_server_time"]
    }
  }
}

为 Zed 配置

添加到你的 Zed settings.json：

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

为 VS Code 配置

如需快速安装，请使用下方的一键安装按钮...

Install with UV in VS Code Install with UV in VS Code Insiders

Install with Docker in VS Code Install with Docker in VS Code Insiders

如需手动安装，请在 VS Code 的用户设置（JSON）文件中添加以下 JSON 块。你可以按 Ctrl + Shift + P 并输入 Preferences: Open User Settings (JSON) 来完成此操作。

或者，你可以将其添加到工作区中名为 .vscode/mcp.json 的文件中。这将允许你与他人共享配置。

注意：使用 mcp.json 文件时需要 mcp 键。

{
  "mcp": {
    "servers": {
      "time": {
        "command": "uvx",
        "args": ["mcp-server-time"]
      }
    }
  }
}
{
  "mcp": {
    "servers": {
      "time": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/time"]
      }
    }
  }
}

为 Zencoder 配置

  1. 转到 Zencoder 菜单（...）

  2. 从下拉菜单中选择 Agent Tools

  3. 点击 Add Custom MCP

  4. 从下方添加名称和服务器配置，并确保点击 Install 按钮

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

自定义 - 系统时区

默认情况下，服务器会自动检测你的系统时区。你可以通过在配置的 args 列表中添加 --local-timezone 参数来覆盖此设置。

示例：

{
  "command": "python",
  "args": ["-m", "mcp_server_time", "--local-timezone=America/New_York"]
}

示例交互

  1. 获取当前时间：

{
  "name": "get_current_time",
  "arguments": {
    "timezone": "Europe/Warsaw"
  }
}

响应：

{
  "timezone": "Europe/Warsaw",
  "datetime": "2024-01-01T13:00:00+01:00",
  "is_dst": false
}

  1. 在时区之间转换时间：

{
  "name": "convert_time",
  "arguments": {
    "source_timezone": "America/New_York",
    "time": "16:30",
    "target_timezone": "Asia/Tokyo"
  }
}

响应：

{
  "source": {
    "timezone": "America/New_York",
    "datetime": "2024-01-01T12:30:00-05:00",
    "is_dst": false
  },
  "target": {
    "timezone": "Asia/Tokyo",
    "datetime": "2024-01-01T12:30:00+09:00",
    "is_dst": false
  },
  "time_difference": "+13.0h",
}

调试

你可以使用 MCP inspector 来调试服务器。对于 uvx 安装：

npx @modelcontextprotocol/inspector uvx mcp-server-time

或者，如果你已将包安装到特定目录或正在对其进行开发：

cd path/to/servers/src/time
npx @modelcontextprotocol/inspector uv run mcp-server-time

为 Claude 准备的问题示例

  1. "现在几点了？"（将使用系统时区）

  2. "东京现在几点了？"

  3. "当纽约是下午 4 点时，伦敦是几点？"

  4. "将东京时间上午 9:30 转换为纽约时间"

构建

Docker 构建：

cd src/time
docker build -t mcp/time .

贡献

我们鼓励贡献，以帮助扩展和改进 mcp-server-time。无论你是想添加新的时间相关工具、增强现有功能，还是改进文档，你的意见都非常宝贵。

有关其他 MCP 服务器和实现模式的示例，请参阅： https://github.com/modelcontextprotocol/servers

欢迎提交 Pull Request！欢迎贡献新想法、错误修复或增强功能，让 mcp-server-time 更加强大和实用。

许可证

mcp-server-time 根据 MIT 许可证授权。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Time MCP Server

    dumyCq
    A
    license
    B
    quality
    D
    maintenance
    Provides time and timezone functionality for LLMs, enabling them to get current time information across different timezones and convert times between zones.
    2
    MIT

  • Time MCP Server

    asaficontact
    A
    license
    B
    quality
    D
    maintenance
    Provides current time information and timezone conversion capabilities using IANA timezone names. Enables LLMs to get current time in any timezone and convert times between different timezones with automatic system timezone detection.
    2
    MIT

  • DateTime MCP Server

    pinkpixel-dev
    A
    license
    A
    quality
    C
    maintenance
    Provides LLMs with current date and time information across any timezone, with configurable defaults and support for IANA timezone identifiers.
    1
    28
    3
    Apache 2.0

  • Time MCP Server

    fisher1006
    A
    license
    B
    quality
    D
    maintenance
    Provides current time information and timezone conversion capabilities using IANA timezone names with automatic system detection. It enables LLMs to fetch local or global times and convert specific timestamps between different regions.
    2
    2
    MIT

View all related MCP servers

Related MCP Connectors

  • time

    A real clock for AI agents: current time, timezone conversion, and DST facts from the IANA tzdb.

  • timezone

    Timezone MCP — wraps WorldTimeAPI (free, no auth)

  • timezone-toolkit

    Timezone tools for agents: convert, world clock, offset, lookup, date math, holidays, slots. x402

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/lchinglen/time-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server