时间工具包（Timezone Toolkit）

仓库概述

名称与作者

• 仓库名称: timezone-toolkit
• 仓库作者: Cicatriiz

仓库网址

• 仓库URL: GitHub 仓库链接

仓库描述

本仓库提供了一个高级的MCP服务器，支持复杂的时间和时区工具，使用者能够在简单的时间转换之外，进行更为深入的时间计算和分析。

项目简介

项目的主要特性包括但不限于：

• 转换时间：从一个时区转换到另一个。
• 获取当前时间：获取指定时区的当前时间。
• 计算日出日落时间：为特定位置和日期计算日出、日落和黄昏时刻。
• 计算月相：为特定日期计算月相。
• 计算时区差异：计算两个时区之间的时间差。
• 列出可用时区：列出可用的IANA时区，可以按区域过滤。
• 计算倒计时：计算到特定日期/事件的剩余时间。
• 计算工作日：计算两个日期之间的工作日（不包括周末）。
• 格式化日期：以各种样式格式化日期。

主要特性与功能

基本的时区转换功能

• 支持在任何IANA时区之间进行时间转换。
• 获取任何时区的当前时间。
• 支持多种时间格式（短格式、中等格式、完整格式）。
• 计算以小时/分钟为单位的时间差。
• 列出所有可用的IANA时区。

日出/日落与天文计算

• 计算任意地点的日出和日落时间。
• 包括黄昏时间（民用、航海、天文）。
• 计算任意地点和日期的白昼长度。
• 计算任何日期的月相。

日期和时间实用工具

• 以多种风格格式化日期（短、中、全格式，ISO，相对）。
• 计算日期之间的工作日。
• 为未来事件创建倒计时计时器。
• 支持多个地区和时区。

安装指南

前提条件

• Node.js：需要18.x或更高版本。

设置

使用Node.js npx快速运行TimezoneToolkit MCP服务器：

npx -y @cicatriz/timezone-toolkit@latest

客户端特定安装步骤

Cursor IDE

在Cursor IDE中添加该服务器：

1. 导航至Cursor设置 > MCP。
2. 点击 + 添加新的全局MCP服务器。
3. 在你的 .cursor/mcp.json 文件中添加如下配置：

{
  "mcpServers": {
    "timezone-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "@cicatriz/timezone-toolkit"
      ]
    }
  }
}

其他集成

类似配置可用于 Windsurf、Cline、Roo Code、Claude 和 CLI。每个客户端都有详细的配置文件修改步骤，可以根据上面Cursor的步骤操作并相应替换文件和路径。

潜在应用场景

1. 全球化企业：为需要跨时区协调会议和活动的企业提供可靠的时间计算。
2. 气象学和天文学：帮助气象学者和天文学爱好者跟踪和预测日出、日落和月相。
3. 金融与物流：支持金融市场时间管理和物流中跨时区交付时间安排。
4. 旅游与旅行：帮助旅行者和旅游公司计划行程。

API访问

TimezoneToolkit还提供RESTful API，用于无需 Claude Desktop 的功能访问。

启动API服务器

# 使用npm启动
npm install -g @cicatriz/timezone-toolkit
node server.js

API 接口

提供多个接口以调用不同功能，如时间转换、当前时间获取、日出日落计算等，详细接口用法请参考API文档。

示例查询

• 查询东京当前时间。
• 将纽约时间的3:00 PM转换为伦敦时间。
• 计算特定地点的日出时间。

贡献

欢迎贡献！

1. Fork 仓库。
2. 创建你的功能分支。
3. 提交更改。
4. 推送到分支。
5. 提交Pull Request。

测试与故障排除

TimezoneToolkit 包含一个全面的测试脚本，以验证 MCP 服务器的功能。可测试本地构建、版本标志以及具体工具功能。

详细步骤可参考测试脚本输出结果及常见问题的排查方法。

隐私与安全

TimezoneToolkit在本地处理所有数据，不会将任何信息发送至外部服务器，保证用户的时区数据和查询私密。

授权许可

作者信息

• 开发者: Cicatriz
• 邮箱: thedawg100@gmail.com