星战科技xingzhan.cloud
返回市场
时间-mcp-服务器

时间-mcp-服务器

作者：okooo5km8 星标更新：2025-04-20
安装使用来源：spider==github.com

项目介绍

Time MCP Server

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

Swift平台 许可证

✨ 特性

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

可用工具

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

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

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

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

安装

选项1：下载预构建二进制文件

从GitHub Releases页面下载适用于您平台的最新预构建二进制文件：

从GitHub Releases页面下载适用于您平台的二进制文件，并按照以下安装说明进行操作。

<details> <summary><b>macOS安装</b></summary>

macOS带Apple Silicon (M1/M2/M3)：

# 下载arm64版本
curl -L https://github.com/okooo5km/time-mcp-server/releases/latest/download/time-mcp-server-macos-arm64.zip -o time-mcp-server.zip
unzip time-mcp-server.zip
chmod +x time-mcp-server

# 移除隔离属性以避免安全警告
xattr -d com.apple.quarantine time-mcp-server

# 安装到本地bin目录
mkdir -p ~/.local/bin
mv time-mcp-server ~/.local/bin/
rm time-mcp-server.zip

macOS带Intel处理器：

# 下载x86_64版本
curl -L https://github.com/okooo5km/time-mcp-server/releases/latest/download/time-mcp-server-macos-x86_64.zip -o time-mcp-server.zip
unzip time-mcp-server.zip
chmod +x time-mcp-server

# 移除隔离属性以避免安全警告
xattr -d com.apple.quarantine time-mcp-server

# 安装到本地bin目录
mkdir -p ~/.local/bin
mv time-mcp-server ~/.local/bin/
rm time-mcp-server.zip

macOS通用二进制文件（适用于Apple Silicon和Intel）：

# 下载通用版本
curl -L https://github.com/okooo5km/time-mcp-server/releases/latest/download/time-mcp-server-macos-universal.zip -o time-mcp-server.zip
unzip time-mcp-server.zip
chmod +x time-mcp-server

# 移除隔离属性以避免安全警告
xattr -d com.apple.quarantine time-mcp-server

# 安装到本地bin目录
mkdir -p ~/.local/bin
mv time-mcp-server ~/.local/bin/
rm time-mcp-server.zip
</details> <details> <summary><b>Linux安装</b></summary>

Linux上x86_64（最常见）：

# 下载amd64版本
curl -L https://github.com/okooo5km/time-mcp-server/releases/latest/download/time-mcp-server-linux-amd64.tar.gz -o time-mcp-server.tar.gz
tar -xzf time-mcp-server.tar.gz
chmod +x time-mcp-server

# 安装到本地bin目录
mkdir -p ~/.local/bin
mv time-mcp-server ~/.local/bin/
rm time-mcp-server.tar.gz

Linux上ARM64（例如Raspberry Pi 4，AWS Graviton）：

# 下载arm64版本
curl -L https://github.com/okooo5km/time-mcp-server/releases/latest/download/time-mcp-server-linux-arm64.tar.gz -o time-mcp-server.tar.gz
tar -xzf time-mcp-server.tar.gz
chmod +x time-mcp-server

# 安装到本地bin目录
mkdir -p ~/.local/bin
mv time-mcp-server ~/.local/bin/
rm time-mcp-server.tar.gz
</details> <details> <summary><b>Windows安装</b></summary>

Windows上x86_64（最常见）：

Windows上ARM64（例如Windows on ARM设备）：

</details>

确保安装目录在您的PATH中：

  • macOS/Linux：在您的shell配置文件（.bashrc，.zshrc等）中添加export PATH="$HOME/.local/bin:$PATH"
  • Windows：通过系统属性 > 环境变量对话框将目录添加到系统PATH

选项2：从源码构建

  1. 克隆仓库：

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

  2. 构建项目：

    使用Make（推荐）：

    # 为当前平台构建
make

# 或为特定平台构建
make build-darwin-universal    # macOS通用二进制文件
make build-darwin-arm64        # macOS Apple Silicon
make build-darwin-amd64        # macOS Intel
make build-linux-amd64         # Linux x86_64
make build-linux-arm64         # Linux ARM64
make build-windows-amd64       # Windows x86_64

# 或一次性构建所有平台
make build-all

# 创建所有平台的分发包
make dist

    二进制文件将被放置在.build目录中。

    直接使用Swift：

    swift build -c release

  3. 安装二进制文件：

    # 安装到用户目录（推荐，无需sudo）
mkdir -p ~/.local/bin
cp 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的版本号
  • -t, --transport <string>：使用的传输类型（默认："stdio"）
    • stdio：直接集成到LLMs的标准输入/输出模式
    • sse：用于基于web连接的Server-Sent Events模式
  • -p, --port <int>：在SSE模式下运行时使用的端口（默认：8080）
  • -l, --local-timezone <string>：覆盖自动检测的本地时区，使用特定的IANA时区名称

示例用法：

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

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

# 使用默认设置启动服务器（stdio模式）
time-mcp-server

# 在默认端口（8080）上以SSE模式启动服务器
time-mcp-server --transport sse

# 在自定义端口上以SSE模式启动服务器
time-mcp-server --transport sse --port 9090

# 使用特定本地时区启动服务器
time-mcp-server --local-timezone Europe/London

当以SSE模式运行时，服务器将通过指定端口上的HTTP可访问，允许基于web的客户端连接。在默认的stdio模式下，服务器通过标准输入/输出通信，这对于直接集成到LLM应用程序非常理想。

配置Claude.app

在您的Claude设置中添加：

"mcpServers": {
  "RealTime": {
    "command": "time-mcp-server",
    "args": ["-l", "Asia/Shanghai"]
  }
}

配置Cursor

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

{
  "mcpServers": {
    "RealTime": {
      "command": "time-mcp-server",
      "args": ["-l", "Asia/Shanghai"]
    }
  }
}

配置ChatWise

在您的Chatwise Settings - Tools中添加记忆MCP服务器。

chatwise-settings-tools

示例系统提示

您可以使用以下系统提示来帮助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 SDK实现的Model Context Protocol (MCP)时间服务器的Swift实现，使AI助手能够访问当前时间信息并在时区之间转换。此项目是使用MCP Swift SDK构建的。