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。

使用 PIP

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

pip install mcp-server-time

安装完成后，您可以将其作为脚本运行：

python -m mcp_server_time

配置

为 Claude.app 配置

添加到您的 Claude 设置：

<details> <summary>使用 uvx</summary>

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

</details>

<details> <summary>使用 docker</summary>

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

</details>

<details> <summary>使用 pip 安装</summary>

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

</details>

为 Zed 配置

添加到您的 Zed settings.json：

<details> <summary>使用 uvx</summary>

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

</details>

<details> <summary>使用 pip 安装</summary>

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

</details>

自定义 - 系统时区

默认情况下，服务器会自动检测您的系统时区。您可以通过在配置中的 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
}

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

{
  "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 文件。