
TimezoneToolkit MCP Server

2025.03.28
0
TypeScript时间管理时区工具日程管理
TimezoneToolkit 是一个基于 MCP(Model Context Protocol)协议的高级时间与时区工具服务器,提供超越基本转换功能的全面时间与时区工具。它支持时间转换、日出日落计算、月相计算、时区列表、倒计时计算、工作日计算等多种功能,适用于需要精确时间管理的场景。
View on GitHub
Overview
基本能力
产品定位
TimezoneToolkit 是一个高级时间与时区工具服务器,旨在提供全面的时间与时区管理功能,适用于开发者和需要精确时间管理的用户。
核心功能
- 基本时区转换
- 在任何 IANA 时区之间转换时间
- 获取任何时区的当前时间
- 以多种样式格式化时间(短、中、长)
- 计算时区差异(小时/分钟)
-
列出可用的 IANA 时区
-
日出/日落和天文计算
- 计算任何位置的日出和日落时间
- 包括晨昏时间(民用、航海、天文)
- 计算任何位置/日期的日照长度
-
计算任何日期的月相
-
日期和时间实用工具
- 以多种样式格式化日期(短、中、长、ISO、相对)
- 计算两个日期之间的工作日
- 创建未来事件的倒计时
- 支持多地区和时区
适用场景
- 跨时区会议安排
- 旅行计划中的时间管理
- 天文观测时间计算
- 项目截止日期和工作日计算
- 多地区时间显示需求
工具列表
- convert_time:将时间从一个时区转换到另一个时区
- get_current_time:获取指定时区的当前时间
- calculate_sunrise_sunset:计算特定位置和日期的日出、日落和晨昏时间
- calculate_moon_phase:计算特定日期的月相
- calculate_timezone_difference:计算两个时区之间的时间差
- list_timezones:列出可用的 IANA 时区,可按地区筛选
- calculate_countdown:计算到特定日期/事件的剩余时间
- calculate_business_days:计算两个日期之间的工作日(排除周末)
- format_date:以多种样式格式化日期
常见问题解答
- 工具未在 Claude Desktop 中显示
- 确保服务器在 Claude Desktop 设置中正确配置
- 检查 index.js 文件的路径是否正确
-
重启 Claude Desktop
-
时区计算不正确
- 确保使用有效的 IANA 时区名称(如 'America/New_York',而非 'EST')
-
检查夏令时转换是否影响计算
-
日出/日落计算不工作
- 确保纬度和经度值有效(纬度 -90 到 90,经度 -180 到 180)
- 极北/极南地区可能在某些时期没有日出/日落
使用教程
使用依赖
- 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