Time Service
](https://www.npmjs.com/package/@qiyuey/time-service) ](https://www.npmjs.com/package/@qiyuey/time-service)    ](https://github.com/qiyuey/time-service) 
🌍 最全面的时间处理 MCP 服务器 - 超越简单的时区转换
Time Service 是一个强大的模型上下文协议（MCP）服务器，为你的 AI 助手带来企业级时间处理能力。提供 8 个专业工具，远超基础时区查询，解决真实世界中的日程安排、时间计算和业务时间处理挑战。
快速链接： 📦 • 🐙 • 📝 更新日志 • 📖 MCP 文档
✨ 为什么选择 Time Service？
🎯 完整解决方案
Time Service 提供 8 个全面的工具，覆盖所有时间处理场景：
- ✅ 时间查询 - 当前时间、时间戳、多时区
- ✅ 时间计算 - 加减时间、计算时间差
- ✅ 时区操作 - 任意时区间转换
- ✅ 业务场景 - 计算工作日、查找下次出现时间
🚀 核心特性
🔄 批量操作 一次调用查询多个时区 - 减少 API 请求，快速获得全球时间概览：
一次调用 → 获取所有时区及 UTC 偏移📅 工作日智能计算 计算截止日期时自动跳过周末 - 非常适合项目管理：
"从今天开始加 5 个工作日" → 自动排除周末⏰ 智能调度 灵活条件查找下次出现时间：
"下周一下午 2 点" ✓
"下个月 15 号" ✓
"下周五 14:00" ✓🎨 灵活格式化 4 种内置格式加自定义配置：
- ISO 8601:
2024-01-15T10:30:00Z - Unix 时间戳:
1705315800 - 人类可读:
Monday, January 15, 2024 at 10:30:00 AM - 自定义: 任何你需要的格式
💪 生产就绪
- ✅ 100% 测试覆盖 - 115 个全面的测试用例
- ✅ 完整类型 - 完整的 TypeScript 类型系统
- ✅ 文档完善 - 清晰的示例和指南
- ✅ 零安装 - 直接使用 npx/bunx
🛠️ 可用工具
| 工具 | 功能 | 使用场景 |
|---|---|---|
| get_current_time | 获取任意格式/时区的当前时间 | 跨时区查看时间 |
| get_timestamp | 获取 Unix 时间戳（秒/毫秒） | 为 API 生成时间戳 |
| add_time | 加减时间段 | "3 天后是什么时间？" |
| time_diff | 计算时间差 | "距离截止日期还有多少小时？" |
| convert_timezone | 时区间转换 | "纽约 9 点是东京几点？" |
| get_multiple_timezones | 一次获取多个时区的时间 | 显示世界时钟 |
| get_business_days | 计算工作日（跳过周末） | 项目截止日期计算 |
| next_occurrence | 查找下次特定日期/时间 | "下周一是几号？"、"下个 15 号？" |
📦 安装
添加到你的 MCP 客户端配置：
{
"mcpServers": {
"time-service": {
"command": "npx",
"args": ["-y", "@qiyuey/time-service"]
}
}
}支持的运行时： npm (Node.js)、bun
🎯 使用示例
真实场景
场景 1：全球团队协作
用户："我们在纽约、伦敦和东京的办公室现在分别是几点？"
Time Service：使用 get_multiple_timezones
→ 一次返回三个时区的时间和 UTC 偏移场景 2：项目截止日期计算
用户："如果从今天开始，10 个工作日后是哪天？"
Time Service：使用 get_business_days
→ 自动跳过周末，返回精确日期场景 3：会议安排
用户："东部时间下午 2 点转换成东京时间是几点？"
Time Service：使用 convert_timezone
→ 自动处理夏令时场景 4：周期性活动规划
用户："下周一早上 9 点是什么时候？"
Time Service：使用 next_occurrence
→ 找到精确的日期和时间API 示例
获取多个时区的时间：
{
"name": "get_multiple_timezones",
"arguments": {
"timezones": ["America/New_York", "Europe/London", "Asia/Tokyo"],
"format": "readable"
}
}计算工作日：
{
"name": "get_business_days",
"arguments": {
"startDate": "2024-01-15T00:00:00Z",
"days": 5,
"excludeWeekends": true
}
}查找下次出现时间：
{
"name": "next_occurrence",
"arguments": {
"dayOfWeek": 1,
"time": "14:00"
}
}🗺️ 路线图
P0 - 核心改进 ✅
- ✅ 代码优化 (v0.3.1) - 提取共享工具，实现 100% 函数覆盖
- ✅ 全面测试 - 115 个测试用例覆盖所有场景
P1 - 高优先级（即将推出）
- 📚 增强文档 - 详细指南和教程
- 🐳 Docker 支持 - 容器化部署就绪
- 🔌 平台集成指南 - Claude Desktop、Zed、VS Code
- ⚡ 性能提升 - 缓存和优化
P2 - 中等优先级（未来）
- 🌍 国际化 - 多语言支持
- 📊 高级计算 - 假期支持、工作时间
- 📈 分析功能 - 使用统计和监控
- 🐍 Python 版本 - 扩展到 Python 生态系统
P3 - 长期愿景
- 🔄 自动更新时区数据库 - 始终保持最新
- 🌐 Web API 服务 - HTTP API 版本
- 🎨 自定义假期日历 - 地区特定假期
- 🔗 第三方集成 - 日历系统、项目管理工具
🤝 贡献
我们欢迎贡献！以下是你可以帮助的方式：
优先领域：
- 🐳 Docker 部署配置
- 📖 文档和集成指南
- ✨ 新的时间计算功能
- 🚀 性能优化
如何贡献：
- Fork 仓库
- 创建你的功能分支（
git checkout -b feature/AmazingFeature） - 提交你的更改（
git commit -m 'Add some AmazingFeature'） - 推送到分支（
git push origin feature/AmazingFeature） - 开启一个 Pull Request
📚 资源
🙋 常见问题
问：Time Service 有什么特别之处？ 答：我们提供 8 个全面的工具，包括工作日计算、批量时区查询、智能时间查找和灵活格式化选项 - 满足所有时间处理需求的完整解决方案。
问：需要安装什么吗？ 答：不需要！在 MCP 配置中直接使用 npx -y @qiyuey/time-service。
问：支持哪些时区？ 答：所有 IANA 时区名称（例如 America/New_York、Asia/Tokyo、Europe/London）。
问：可以使用自定义日期格式吗？ 答：可以！支持 ISO、Unix、人类可读格式和自定义 Intl.DateTimeFormat 配置。
问：生产环境可用吗？ 答：绝对可以！100% 函数覆盖、115 个测试用例、完整类型支持，并持续维护。
📄 许可证
本项目采用 MIT 许可证 - 详见 LICENSE 文件。
本项目同时支持 反 996 许可证。使用本软件即表示您同意遵守劳动法律法规，不强制员工在没有合理补偿的情况下加班。
附加条款：
- 本软件仅供学习、研究和合法商业用途
- 用户必须遵守当地劳动法律法规
- 禁止使用本软件剥削员工或侵犯劳动权益
MIT © qiyuey
为 MCP 生态系统用心打造
  
⭐ 如果觉得有用，请在 GitHub 上给个星！ ⭐