Time MCP 服务器

一个模型上下文协议 (Model Context Protocol, MCP) 服务器，提供与时间相关的功能。该服务器使 LLM 能够访问当前时间信息并在不同时区之间转换时间。这是使用 MCP Swift SDK 的时间 MCP 服务器的 Swift 实现。

✨ 功能

• 当前时间查询: 获取任何时区的当前时间
• 时区转换: 在不同时区之间转换时间
• 夏令时信息: 检查某个时区当前是否处于夏令时
• 时差计算: 获取时区转换时的时差

可用工具

• get_current_time - 获取特定时区的当前时间

  • timezone (字符串，必需): IANA 时区名称 (例如，'America/New_York', 'Europe/London')。如果为空或未提供，将使用系统时区。

• convert_time - 在时区之间转换时间

  • source_timezone (字符串，必需): 源 IANA 时区名称。如果为空或未提供，将使用系统时区。
  • time (字符串，必需): 要转换的时间，采用 24 小时制格式 (HH:MM)
  • target_timezone (字符串，必需): 目标 IANA 时区名称。如果为空或未提供，将使用系统时区。

安装

选项 1：一键安装 (curl)

最简单的安装方式是使用一键安装程序，它会自动下载最新版本并将其安装到您主目录中的 ~/.local/bin：

curl -fsSL https://raw.githubusercontent.com/okooo5km/time-mcp-server/main/install.sh | bash

安装程序将：

• 创建 ~/.local/bin (如果它不存在)
• 将此目录添加到您的 PATH (在 .zshrc 或 .bashrc 中)
• 下载并安装最新版本
• 使二进制文件可执行

选项 2：从源代码构建

1. 克隆存储库：

   git clone https://github.com/okooo5km/time-mcp-server.git
   cd time-mcp-server
   

2. 构建项目：

   swift build -c release
   

3. 安装二进制文件：

   # 安装到用户目录（推荐，无需 sudo）
   mkdir -p ~/.local/bin
   cp $(swift build -c release --show-bin-path)/time-mcp-server ~/.local/bin/
   

   确保 ~/.local/bin 在您的 PATH 中，方法是将其添加到您的 shell 配置文件：

   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc  # 或 ~/.bashrc
   source ~/.zshrc  # 或 source ~/.bashrc
   

命令行参数

服务器支持以下命令行参数：

• -h, --help: 显示有关服务器、其用法和可用选项的帮助信息
• -v, --version: 显示 time-mcp-server 的版本号

用法示例：

# 显示帮助信息
time-mcp-server --help

# 显示版本信息
time-mcp-server --version

为 Claude.app 配置

添加到您的 Claude 设置：

"mcpServers": {
  "RealTime": {
    "command": "time-mcp-server"
  }
}

为 Cursor 配置

将以下配置添加到您的 Cursor 编辑器的 Settings - mcp.json：

{
  "mcpServers": {
    "RealTime": {
      "command": "time-mcp-server"
    }
  }
}

为 ChatWise 配置

将内存 MCP 服务器添加到您的 Chatwise 设置 - 工具。

示例系统提示

您可以使用以下系统提示来帮助 Claude 有效地利用 time-mcp-server：

您可以通过 MCP 访问与时间相关的工具。使用这些工具来帮助用户：

- 获取任何时区的当前时间
- 在时区之间转换时间
- 计算不同位置之间的时差
- 计划跨不同时区的会议

适当使用以下工具：
- `get_current_time` 用于检查特定时区的当前时间
- `convert_time` 当用户需要在时区之间进行转换时

始终使用正确的 IANA 时区名称（例如，'America/New_York'、'Europe/London'、'Asia/Tokyo'），
而不是缩写或常用名称。

开发要求

• Swift 6.0 或更高版本
• macOS 14.0 或更高版本
• MCP Swift SDK 0.2.0 或更高版本

使用示例

获取当前时间

{
  "timezone": "America/New_York"
}

响应：

{
  "timezone": "America/New_York",
  "datetime": "2024-11-05T14:30:45-05:00",
  "is_dst": false
}

转换时间

{
  "source_timezone": "America/Los_Angeles",
  "time": "15:30",
  "target_timezone": "Asia/Tokyo"
}

响应：

{
  "source": {
    "timezone": "America/Los_Angeles",
    "datetime": "2024-11-05T15:30:00-08:00",
    "is_dst": false
  },
  "target": {
    "timezone": "Asia/Tokyo",
    "datetime": "2024-11-06T08:30:00+09:00",
    "is_dst": false
  },
  "time_difference": "+17h"
}

使用场景

• 国际会议计划: 安排跨不同时区的会议
• 旅行计划: 检查目的地的当地时间
• 远程工作协调: 与国际团队协调工作时间
• 活动安排: 设置具有正确当地时间的全球活动
• 时间敏感型操作: 确保操作在正确的当地时间发生

版本历史

请参阅 GitHub Releases 以获取版本历史和变更日志。

☕️ 支持项目

如果您觉得 time-mcp-server 有帮助，请考虑支持其开发：

• ⭐️ 在 GitHub 上为项目点赞
• 🐛 报告错误或建议功能
• 💝 通过以下方式支持：

<p align="center"> <a href="https://buymeacoffee.com/okooo5km"> <img src="https://img.buymeacoffee.com/button-api/?text=Buy me a coffee&emoji=&slug=okooo5km&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff" style="border-radius: 8px;" /> </a> </p>

许可证

time-mcp-server 在 MIT 许可证下获得许可。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。

关于

用于模型上下文协议 (MCP) 的时间服务器的 Swift 实现，使 AI 助手能够访问当前时间信息并在时区之间进行转换。该项目是使用 MCP Swift SDK 构建的。