TimezoneToolkit MCP Server

TimezoneToolkit MCP Server

site icon
2025.03.28 0
TypeScript时间管理时区工具日程管理
TimezoneToolkit 是一个基于 MCP(Model Context Protocol)协议的高级时间与时区工具服务器,提供超越基本转换功能的全面时间与时区工具。它支持时间转换、日出日落计算、月相计算、时区列表、倒计时计算、工作日计算等多种功能,适用于需要精确时间管理的场景。
View on GitHub

Overview

基本能力

产品定位

TimezoneToolkit 是一个高级时间与时区工具服务器,旨在提供全面的时间与时区管理功能,适用于开发者和需要精确时间管理的用户。

核心功能

  1. 基本时区转换
  2. 在任何 IANA 时区之间转换时间
  3. 获取任何时区的当前时间
  4. 以多种样式格式化时间(短、中、长)
  5. 计算时区差异(小时/分钟)
  6. 列出可用的 IANA 时区

  7. 日出/日落和天文计算

  8. 计算任何位置的日出和日落时间
  9. 包括晨昏时间(民用、航海、天文)
  10. 计算任何位置/日期的日照长度
  11. 计算任何日期的月相

  12. 日期和时间实用工具

  13. 以多种样式格式化日期(短、中、长、ISO、相对)
  14. 计算两个日期之间的工作日
  15. 创建未来事件的倒计时
  16. 支持多地区和时区

适用场景

  • 跨时区会议安排
  • 旅行计划中的时间管理
  • 天文观测时间计算
  • 项目截止日期和工作日计算
  • 多地区时间显示需求

工具列表

  1. convert_time:将时间从一个时区转换到另一个时区
  2. get_current_time:获取指定时区的当前时间
  3. calculate_sunrise_sunset:计算特定位置和日期的日出、日落和晨昏时间
  4. calculate_moon_phase:计算特定日期的月相
  5. calculate_timezone_difference:计算两个时区之间的时间差
  6. list_timezones:列出可用的 IANA 时区,可按地区筛选
  7. calculate_countdown:计算到特定日期/事件的剩余时间
  8. calculate_business_days:计算两个日期之间的工作日(排除周末)
  9. format_date:以多种样式格式化日期

常见问题解答

  1. 工具未在 Claude Desktop 中显示
  2. 确保服务器在 Claude Desktop 设置中正确配置
  3. 检查 index.js 文件的路径是否正确
  4. 重启 Claude Desktop

  5. 时区计算不正确

  6. 确保使用有效的 IANA 时区名称(如 'America/New_York',而非 'EST')
  7. 检查夏令时转换是否影响计算

  8. 日出/日落计算不工作

  9. 确保纬度和经度值有效(纬度 -90 到 90,经度 -180 到 180)
  10. 极北/极南地区可能在某些时期没有日出/日落

使用教程

使用依赖

  • Node.js 18.x 或更高版本

安装教程

使用 npx 运行

npx -y @cicatriz/timezone-toolkit@latest

从 npm 安装

# 全局安装
npm install -g @cicatriz/timezone-toolkit

# 运行服务器
timezone-toolkit

手动安装

# 克隆仓库
git clone https://github.com/Cicatriiz/timezone-toolkit.git
cd timezone-toolkit

# 安装依赖
npm install

# 构建项目
npm run build

# 运行服务器
node dist/index.js

调试方式

运行测试

# 测试本地构建(默认)
node test-server.js

# 测试特定工具
node test-server.js --tool=calculate_sunrise_sunset

# 列出所有可用工具
node test-server.js --list

# 测试版本标志
node test-server.js --test-version

# 测试发布的 npm 包(发布后)
node test-server.js --npm

许可证

该项目遵循 ISC 开源许可条款,请参阅 ISC 了解完整条款。