feat: 初始化MCP时间服务器项目
添加核心功能模块包括时间工具集、服务器实现和测试 配置项目基础设置如ESLint、Prettier和Vitest 实现时间相关功能包括当前时间、时区信息和日期计算 添加README文档说明项目功能和使用方法
This commit is contained in:
269
.gitignore
vendored
Normal file
269
.gitignore
vendored
Normal file
@@ -0,0 +1,269 @@
|
|||||||
|
# Dependencies
|
||||||
|
node_modules/
|
||||||
|
npm-debug.log*
|
||||||
|
yarn-debug.log*
|
||||||
|
yarn-error.log*
|
||||||
|
pnpm-debug.log*
|
||||||
|
|
||||||
|
# Runtime data
|
||||||
|
pids
|
||||||
|
*.pid
|
||||||
|
*.seed
|
||||||
|
*.pid.lock
|
||||||
|
|
||||||
|
# Coverage directory used by tools like istanbul
|
||||||
|
coverage/
|
||||||
|
*.lcov
|
||||||
|
|
||||||
|
# nyc test coverage
|
||||||
|
.nyc_output
|
||||||
|
|
||||||
|
# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
|
||||||
|
.grunt
|
||||||
|
|
||||||
|
# Bower dependency directory (https://bower.io/)
|
||||||
|
bower_components
|
||||||
|
|
||||||
|
# node-waf configuration
|
||||||
|
.lock-wscript
|
||||||
|
|
||||||
|
# Compiled binary addons (https://nodejs.org/api/addons.html)
|
||||||
|
build/Release
|
||||||
|
|
||||||
|
# Dependency directories
|
||||||
|
node_modules/
|
||||||
|
jspm_packages/
|
||||||
|
|
||||||
|
# TypeScript cache
|
||||||
|
*.tsbuildinfo
|
||||||
|
|
||||||
|
# Optional npm cache directory
|
||||||
|
.npm
|
||||||
|
|
||||||
|
# Optional eslint cache
|
||||||
|
.eslintcache
|
||||||
|
|
||||||
|
# Optional stylelint cache
|
||||||
|
.stylelintcache
|
||||||
|
|
||||||
|
# Microbundle cache
|
||||||
|
.rpt2_cache/
|
||||||
|
.rts2_cache_cjs/
|
||||||
|
.rts2_cache_es/
|
||||||
|
.rts2_cache_umd/
|
||||||
|
|
||||||
|
# Optional REPL history
|
||||||
|
.node_repl_history
|
||||||
|
|
||||||
|
# Output of 'npm pack'
|
||||||
|
*.tgz
|
||||||
|
|
||||||
|
# Yarn Integrity file
|
||||||
|
.yarn-integrity
|
||||||
|
|
||||||
|
# dotenv environment variable files
|
||||||
|
.env
|
||||||
|
.env.development.local
|
||||||
|
.env.test.local
|
||||||
|
.env.production.local
|
||||||
|
.env.local
|
||||||
|
|
||||||
|
# parcel-bundler cache (https://parceljs.org/)
|
||||||
|
.cache
|
||||||
|
.parcel-cache
|
||||||
|
|
||||||
|
# Next.js build output
|
||||||
|
.next
|
||||||
|
out
|
||||||
|
|
||||||
|
# Nuxt.js build / generate output
|
||||||
|
.nuxt
|
||||||
|
dist
|
||||||
|
|
||||||
|
# Gatsby files
|
||||||
|
.cache/
|
||||||
|
public
|
||||||
|
|
||||||
|
# Storybook build outputs
|
||||||
|
.out
|
||||||
|
.storybook-out
|
||||||
|
|
||||||
|
# Temporary folders
|
||||||
|
tmp/
|
||||||
|
temp/
|
||||||
|
|
||||||
|
# Runtime data
|
||||||
|
pids
|
||||||
|
*.pid
|
||||||
|
*.seed
|
||||||
|
*.pid.lock
|
||||||
|
|
||||||
|
# Directory for instrumented libs generated by jscoverage/JSCover
|
||||||
|
lib-cov
|
||||||
|
|
||||||
|
# Coverage directory used by tools like istanbul
|
||||||
|
coverage
|
||||||
|
*.lcov
|
||||||
|
|
||||||
|
# Logs
|
||||||
|
logs
|
||||||
|
*.log
|
||||||
|
npm-debug.log*
|
||||||
|
yarn-debug.log*
|
||||||
|
yarn-error.log*
|
||||||
|
lerna-debug.log*
|
||||||
|
.pnpm-debug.log*
|
||||||
|
|
||||||
|
# Diagnostic reports (https://nodejs.org/api/report.html)
|
||||||
|
report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
|
||||||
|
|
||||||
|
# Runtime data
|
||||||
|
pids
|
||||||
|
*.pid
|
||||||
|
*.seed
|
||||||
|
*.pid.lock
|
||||||
|
|
||||||
|
# Directory for instrumented libs generated by jscoverage/JSCover
|
||||||
|
lib-cov
|
||||||
|
|
||||||
|
# Coverage directory used by tools like istanbul
|
||||||
|
coverage
|
||||||
|
*.lcov
|
||||||
|
|
||||||
|
# nyc test coverage
|
||||||
|
.nyc_output
|
||||||
|
|
||||||
|
# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
|
||||||
|
.grunt
|
||||||
|
|
||||||
|
# Bower dependency directory (https://bower.io/)
|
||||||
|
bower_components
|
||||||
|
|
||||||
|
# node-waf configuration
|
||||||
|
.lock-wscript
|
||||||
|
|
||||||
|
# Compiled binary addons (https://nodejs.org/api/addons.html)
|
||||||
|
build/Release
|
||||||
|
|
||||||
|
# Dependency directories
|
||||||
|
node_modules/
|
||||||
|
jspm_packages/
|
||||||
|
|
||||||
|
# Snowpack dependency directory (https://snowpack.dev/)
|
||||||
|
web_modules/
|
||||||
|
|
||||||
|
# TypeScript cache
|
||||||
|
*.tsbuildinfo
|
||||||
|
|
||||||
|
# Optional npm cache directory
|
||||||
|
.npm
|
||||||
|
|
||||||
|
# Optional eslint cache
|
||||||
|
.eslintcache
|
||||||
|
|
||||||
|
# Optional stylelint cache
|
||||||
|
.stylelintcache
|
||||||
|
|
||||||
|
# Microbundle cache
|
||||||
|
.rpt2_cache/
|
||||||
|
.rts2_cache_cjs/
|
||||||
|
.rts2_cache_es/
|
||||||
|
.rts2_cache_umd/
|
||||||
|
|
||||||
|
# Optional REPL history
|
||||||
|
.node_repl_history
|
||||||
|
|
||||||
|
# Output of 'npm pack'
|
||||||
|
*.tgz
|
||||||
|
|
||||||
|
# Yarn Integrity file
|
||||||
|
.yarn-integrity
|
||||||
|
|
||||||
|
# dotenv environment variable files
|
||||||
|
.env
|
||||||
|
.env.development.local
|
||||||
|
.env.test.local
|
||||||
|
.env.production.local
|
||||||
|
.env.local
|
||||||
|
|
||||||
|
# parcel-bundler cache (https://parceljs.org/)
|
||||||
|
.cache
|
||||||
|
.parcel-cache
|
||||||
|
|
||||||
|
# Next.js build output
|
||||||
|
.next
|
||||||
|
out
|
||||||
|
|
||||||
|
# Nuxt.js build / generate output
|
||||||
|
.nuxt
|
||||||
|
dist
|
||||||
|
|
||||||
|
# Gatsby files
|
||||||
|
.cache/
|
||||||
|
public
|
||||||
|
|
||||||
|
# vuepress build output
|
||||||
|
.vuepress/dist
|
||||||
|
|
||||||
|
# vuepress v2.x temp and cache directory
|
||||||
|
.temp
|
||||||
|
.cache
|
||||||
|
|
||||||
|
# Docusaurus cache and generated files
|
||||||
|
.docusaurus
|
||||||
|
|
||||||
|
# Serverless directories
|
||||||
|
.serverless/
|
||||||
|
|
||||||
|
# FuseBox cache
|
||||||
|
.fusebox/
|
||||||
|
|
||||||
|
# DynamoDB Local files
|
||||||
|
.dynamodb/
|
||||||
|
|
||||||
|
# TernJS port file
|
||||||
|
.tern-port
|
||||||
|
|
||||||
|
# Stores VSCode versions used for testing VSCode extensions
|
||||||
|
.vscode-test
|
||||||
|
|
||||||
|
# yarn v2
|
||||||
|
.yarn/cache
|
||||||
|
.yarn/unplugged
|
||||||
|
.yarn/build-state.yml
|
||||||
|
.yarn/install-state.gz
|
||||||
|
.pnp.*
|
||||||
|
|
||||||
|
# IntelliJ based IDEs
|
||||||
|
.idea
|
||||||
|
|
||||||
|
# Finder (MacOS)
|
||||||
|
.DS_Store
|
||||||
|
|
||||||
|
# Windows
|
||||||
|
Thumbs.db
|
||||||
|
ehthumbs.db
|
||||||
|
Desktop.ini
|
||||||
|
|
||||||
|
# VS Code
|
||||||
|
.vscode/
|
||||||
|
!.vscode/settings.json
|
||||||
|
!.vscode/tasks.json
|
||||||
|
!.vscode/launch.json
|
||||||
|
!.vscode/extensions.json
|
||||||
|
*.code-workspace
|
||||||
|
|
||||||
|
# Local History for Visual Studio Code
|
||||||
|
.history/
|
||||||
|
|
||||||
|
# Built Visual Studio Code Extensions
|
||||||
|
*.vsix
|
||||||
|
|
||||||
|
# MCP specific
|
||||||
|
*.mcp
|
||||||
|
.mcp/
|
||||||
|
|
||||||
|
# Test artifacts
|
||||||
|
test-results/
|
||||||
|
playwright-report/
|
||||||
|
test-results.xml
|
||||||
11
.prettierrc
Normal file
11
.prettierrc
Normal file
@@ -0,0 +1,11 @@
|
|||||||
|
{
|
||||||
|
"semi": true,
|
||||||
|
"trailingComma": "es5",
|
||||||
|
"singleQuote": true,
|
||||||
|
"printWidth": 80,
|
||||||
|
"tabWidth": 2,
|
||||||
|
"useTabs": false,
|
||||||
|
"bracketSpacing": true,
|
||||||
|
"arrowParens": "avoid",
|
||||||
|
"endOfLine": "lf"
|
||||||
|
}
|
||||||
307
README.md
307
README.md
@@ -1,2 +1,307 @@
|
|||||||
# mcp-zero
|
# MCP Time Server
|
||||||
|
|
||||||
|
一个基于 Model Context Protocol (MCP) 的时间工具服务器，提供丰富的时间相关功能。
|
||||||
|
|
||||||
|
## 功能特性
|
||||||
|
|
||||||
|
### 时间工具
|
||||||
|
- **getCurrentTime**: 获取当前时间，支持多种时区和格式
|
||||||
|
- **getTimezone**: 获取时区信息，包括偏移量、缩写等
|
||||||
|
- **formatTime**: 格式化时间，支持多种格式和语言环境
|
||||||
|
- **calculateDateDifference**: 计算两个日期之间的差值
|
||||||
|
- **getWorldClock**: 获取多个时区的世界时钟
|
||||||
|
|
||||||
|
### 支持的时区
|
||||||
|
- 全球主要时区（如 Asia/Shanghai, America/New_York, Europe/London 等）
|
||||||
|
- UTC 和本地时区
|
||||||
|
- 自动夏令时检测
|
||||||
|
|
||||||
|
### 支持的格式
|
||||||
|
- ISO 8601 格式
|
||||||
|
- Unix 时间戳
|
||||||
|
- 本地化格式
|
||||||
|
- 自定义格式
|
||||||
|
|
||||||
|
## 安装和运行
|
||||||
|
|
||||||
|
### 安装依赖
|
||||||
|
```bash
|
||||||
|
npm install
|
||||||
|
```
|
||||||
|
|
||||||
|
### 运行服务器
|
||||||
|
```bash
|
||||||
|
npm start
|
||||||
|
```
|
||||||
|
|
||||||
|
### 运行测试
|
||||||
|
```bash
|
||||||
|
npm test
|
||||||
|
```
|
||||||
|
|
||||||
|
### 代码检查
|
||||||
|
```bash
|
||||||
|
npm run lint
|
||||||
|
```
|
||||||
|
|
||||||
|
## 项目结构
|
||||||
|
|
||||||
|
```
|
||||||
|
src/
|
||||||
|
├── index.js # MCP 服务器入口
|
||||||
|
├── tools/
|
||||||
|
│ ├── index.js # 工具导出
|
||||||
|
│ ├── current-time.js # 当前时间工具
|
||||||
|
│ ├── timezone.js # 时区信息工具
|
||||||
|
│ ├── format-time.js # 时间格式化工具
|
||||||
|
│ ├── date-calculator.js # 日期计算工具
|
||||||
|
│ └── world-clock.js # 世界时钟工具
|
||||||
|
tests/
|
||||||
|
└── time-tools.test.js # 测试文件
|
||||||
|
```
|
||||||
|
|
||||||
|
## 使用示例
|
||||||
|
|
||||||
|
### 获取当前时间
|
||||||
|
```javascript
|
||||||
|
// 获取 UTC 时间
|
||||||
|
getCurrentTime({ timezone: 'UTC', format: 'iso' })
|
||||||
|
|
||||||
|
// 获取上海时间
|
||||||
|
getCurrentTime({ timezone: 'Asia/Shanghai', format: 'locale' })
|
||||||
|
```
|
||||||
|
|
||||||
|
### 获取时区信息
|
||||||
|
```javascript
|
||||||
|
// 获取时区详细信息
|
||||||
|
getTimezone({ timezone: 'Asia/Shanghai' })
|
||||||
|
```
|
||||||
|
|
||||||
|
### 格式化时间
|
||||||
|
```javascript
|
||||||
|
// 格式化时间
|
||||||
|
formatTime({
|
||||||
|
time: '2024-01-01T12:00:00Z',
|
||||||
|
format: 'custom',
|
||||||
|
customFormat: 'YYYY-MM-DD HH:mm:ss',
|
||||||
|
timezone: 'Asia/Shanghai'
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
|
### 计算日期差值
|
||||||
|
```javascript
|
||||||
|
// 计算两个日期的差值
|
||||||
|
calculateDateDifference({
|
||||||
|
startDate: '2024-01-01',
|
||||||
|
endDate: '2024-12-31',
|
||||||
|
unit: 'days'
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
|
### 获取世界时钟
|
||||||
|
```javascript
|
||||||
|
// 获取多个时区的时间
|
||||||
|
getWorldClock({
|
||||||
|
timezones: ['UTC', 'Asia/Shanghai', 'America/New_York'],
|
||||||
|
format: 'locale'
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
|
## 技术栈
|
||||||
|
|
||||||
|
- **Node.js**: 运行时环境
|
||||||
|
- **MCP SDK**: Model Context Protocol 支持
|
||||||
|
- **Zod**: 参数验证
|
||||||
|
- **Vitest**: 测试框架
|
||||||
|
- **ESLint**: 代码检查
|
||||||
|
|
||||||
|
## 开发
|
||||||
|
|
||||||
|
### 添加新工具
|
||||||
|
1. 在 `src/tools/` 目录下创建新的工具文件
|
||||||
|
2. 实现工具的 `name`、`description`、`inputSchema` 和 `handler`
|
||||||
|
3. 在 `src/tools/index.js` 中导出新工具
|
||||||
|
4. 添加相应的测试用例
|
||||||
|
|
||||||
|
### 代码规范
|
||||||
|
- 使用 ESLint 进行代码检查
|
||||||
|
- 遵循 JavaScript 标准代码风格
|
||||||
|
- 所有工具必须包含完整的参数验证
|
||||||
|
- 返回格式必须符合 MCP 协议规范
|
||||||
|
|
||||||
|
## 许可证
|
||||||
|
|
||||||
|
MIT License
|
||||||
|
|
||||||
|
## 工具详情
|
||||||
|
|
||||||
|
### getCurrentTime
|
||||||
|
|
||||||
|
获取当前时间，支持指定时区和格式。
|
||||||
|
|
||||||
|
**参数：**
|
||||||
|
- `timezone` (可选): 时区标识符，如 'UTC', 'America/New_York'
|
||||||
|
- `format` (可选): 输出格式 ('iso', 'timestamp', 'locale')
|
||||||
|
|
||||||
|
**示例：**
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"timezone": "Asia/Shanghai",
|
||||||
|
"format": "iso"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### getTimezone
|
||||||
|
|
||||||
|
获取指定时区的详细信息。
|
||||||
|
|
||||||
|
**参数：**
|
||||||
|
- `timezone` (必需): 时区标识符
|
||||||
|
|
||||||
|
**示例：**
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"timezone": "Europe/London"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### formatTime
|
||||||
|
|
||||||
|
将时间格式化为指定格式。
|
||||||
|
|
||||||
|
**参数：**
|
||||||
|
- `time` (必需): 要格式化的时间
|
||||||
|
- `format` (可选): 输出格式 ('iso', 'timestamp', 'locale', 'custom')
|
||||||
|
- `timezone` (可选): 目标时区
|
||||||
|
- `locale` (可选): 本地化设置
|
||||||
|
- `customFormat` (可选): 自定义格式字符串 (当format为custom时使用)
|
||||||
|
|
||||||
|
**示例：**
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"time": "2024-01-01T12:00:00Z",
|
||||||
|
"format": "locale",
|
||||||
|
"timezone": "Asia/Tokyo",
|
||||||
|
"locale": "ja-JP"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### calculateDateDifference
|
||||||
|
|
||||||
|
计算两个日期之间的差值。
|
||||||
|
|
||||||
|
**参数：**
|
||||||
|
- `startDate` (必需): 开始日期
|
||||||
|
- `endDate` (必需): 结束日期
|
||||||
|
- `unit` (可选): 计算单位 ('years', 'months', 'days', 'hours', 'minutes', 'seconds', 'milliseconds')
|
||||||
|
- `includeTime` (可选): 是否包含时间部分
|
||||||
|
|
||||||
|
**示例：**
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"startDate": "2024-01-01",
|
||||||
|
"endDate": "2024-12-31",
|
||||||
|
"unit": "days"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### getWorldClock
|
||||||
|
|
||||||
|
获取多个时区的当前时间。
|
||||||
|
|
||||||
|
**参数：**
|
||||||
|
- `timezones` (可选): 时区列表，默认为 ['UTC', 'Asia/Shanghai', 'America/New_York', 'Europe/London']
|
||||||
|
- `format` (可选): 时间格式 ('iso', 'locale', 'custom')，默认为 'locale'
|
||||||
|
- `customFormat` (可选): 自定义格式模板 (当format为custom时使用)
|
||||||
|
- `includeOffset` (可选): 是否包含UTC偏移量信息，默认为 true
|
||||||
|
|
||||||
|
**示例：**
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"timezones": ["UTC", "America/New_York", "Asia/Shanghai", "Europe/London"],
|
||||||
|
"format": "locale",
|
||||||
|
"includeOffset": true
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 开发
|
||||||
|
|
||||||
|
### 项目结构
|
||||||
|
|
||||||
|
```
|
||||||
|
mcp-time-server/
|
||||||
|
├── src/
|
||||||
|
│ ├── index.js # 主服务器文件
|
||||||
|
│ ├── tools/ # 工具模块
|
||||||
|
│ │ ├── index.js # 工具导出
|
||||||
|
│ │ ├── current-time.js
|
||||||
|
│ │ ├── timezone.js
|
||||||
|
│ │ ├── format-time.js
|
||||||
|
│ │ ├── date-calculator.js
|
||||||
|
│ │ └── world-clock.js
|
||||||
|
│ └── utils/ # 工具函数 (预留)
|
||||||
|
├── tests/ # 测试文件
|
||||||
|
└── bin/ # 可执行文件
|
||||||
|
```
|
||||||
|
|
||||||
|
### 运行测试
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm test
|
||||||
|
```
|
||||||
|
|
||||||
|
### 代码检查
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm run lint
|
||||||
|
```
|
||||||
|
|
||||||
|
### 代码格式化
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm run format
|
||||||
|
```
|
||||||
|
|
||||||
|
## 技术栈
|
||||||
|
|
||||||
|
- **Node.js** - 运行时环境
|
||||||
|
- **@modelcontextprotocol/sdk** - MCP 协议支持
|
||||||
|
- **Zod** - 数据验证
|
||||||
|
- **Vitest** - 测试框架
|
||||||
|
- **ESLint** - 代码检查
|
||||||
|
- **Prettier** - 代码格式化
|
||||||
|
|
||||||
|
## 许可证
|
||||||
|
|
||||||
|
MIT License
|
||||||
|
|
||||||
|
## 贡献
|
||||||
|
|
||||||
|
欢迎提交 Issue 和 Pull Request！
|
||||||
|
|
||||||
|
### 开发指南
|
||||||
|
|
||||||
|
1. Fork 项目
|
||||||
|
2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
|
||||||
|
3. 提交更改 (`git commit -m 'Add some amazing feature'`)
|
||||||
|
4. 推送到分支 (`git push origin feature/amazing-feature`)
|
||||||
|
5. 打开 Pull Request
|
||||||
|
|
||||||
|
### 代码规范
|
||||||
|
|
||||||
|
- 使用 ESLint 和 Prettier 保持代码风格一致
|
||||||
|
- 编写测试用例覆盖新功能
|
||||||
|
- 遵循现有的代码结构和命名约定
|
||||||
|
- 添加适当的错误处理和参数验证
|
||||||
|
|
||||||
|
## 支持
|
||||||
|
|
||||||
|
如果您遇到问题或有建议，请：
|
||||||
|
|
||||||
|
1. 查看现有的 [Issues](../../issues)
|
||||||
|
2. 创建新的 Issue 描述问题
|
||||||
|
3. 提供详细的错误信息和复现步骤
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**MCP Time Server** - 让时间处理变得简单而强大！ 🚀
|
||||||
19
bin/mcp-time.js
Executable file
19
bin/mcp-time.js
Executable file
@@ -0,0 +1,19 @@
|
|||||||
|
#!/usr/bin/env node
|
||||||
|
|
||||||
|
/**
|
||||||
|
* MCP Time Server 命令行启动器
|
||||||
|
*/
|
||||||
|
|
||||||
|
import { TimeServer } from '../src/index.js';
|
||||||
|
|
||||||
|
async function main() {
|
||||||
|
try {
|
||||||
|
const server = new TimeServer();
|
||||||
|
await server.start();
|
||||||
|
} catch (error) {
|
||||||
|
console.error('Failed to start MCP Time Server:', error);
|
||||||
|
process.exit(1);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
main();
|
||||||
39
eslint.config.js
Normal file
39
eslint.config.js
Normal file
@@ -0,0 +1,39 @@
|
|||||||
|
import js from "@eslint/js";
|
||||||
|
import globals from "globals";
|
||||||
|
|
||||||
|
export default [
|
||||||
|
{
|
||||||
|
files: ["**/*.{js,mjs,cjs}"],
|
||||||
|
languageOptions: {
|
||||||
|
ecmaVersion: 2022,
|
||||||
|
sourceType: "module",
|
||||||
|
globals: {
|
||||||
|
...globals.node,
|
||||||
|
...globals.es2022,
|
||||||
|
},
|
||||||
|
},
|
||||||
|
rules: {
|
||||||
|
...js.configs.recommended.rules,
|
||||||
|
"no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
|
||||||
|
"no-console": "off",
|
||||||
|
"prefer-const": "error",
|
||||||
|
"no-var": "error",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
files: ["tests/**/*.js"],
|
||||||
|
languageOptions: {
|
||||||
|
globals: {
|
||||||
|
...globals.node,
|
||||||
|
...globals.es2022,
|
||||||
|
describe: "readonly",
|
||||||
|
it: "readonly",
|
||||||
|
test: "readonly",
|
||||||
|
expect: "readonly",
|
||||||
|
beforeEach: "readonly",
|
||||||
|
afterEach: "readonly",
|
||||||
|
vi: "readonly",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
];
|
||||||
3337
package-lock.json
generated
Normal file
3337
package-lock.json
generated
Normal file
File diff suppressed because it is too large
Load Diff
51
package.json
Normal file
51
package.json
Normal file
@@ -0,0 +1,51 @@
|
|||||||
|
{
|
||||||
|
"name": "mcp-time-server",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"description": "A Model Context Protocol (MCP) server for time-related tools and utilities",
|
||||||
|
"type": "module",
|
||||||
|
"main": "src/index.js",
|
||||||
|
"bin": {
|
||||||
|
"mcp-time": "./bin/mcp-time.js"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"start": "node src/index.js",
|
||||||
|
"dev": "node --watch src/index.js",
|
||||||
|
"test": "vitest",
|
||||||
|
"test:watch": "vitest --watch",
|
||||||
|
"lint": "eslint src tests",
|
||||||
|
"lint:fix": "eslint src tests --fix",
|
||||||
|
"format": "prettier --write src tests",
|
||||||
|
"format:check": "prettier --check src tests"
|
||||||
|
},
|
||||||
|
"repository": {
|
||||||
|
"type": "git",
|
||||||
|
"url": "http://60.205.233.184:3010/deastern/mcp-zero.git"
|
||||||
|
},
|
||||||
|
"keywords": [
|
||||||
|
"mcp",
|
||||||
|
"model-context-protocol",
|
||||||
|
"time",
|
||||||
|
"datetime",
|
||||||
|
"timezone",
|
||||||
|
"claude",
|
||||||
|
"ai-tools"
|
||||||
|
],
|
||||||
|
"author": "MCP Time Team",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18.0.0"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"@modelcontextprotocol/sdk": "^1.17.3",
|
||||||
|
"zod": "^3.25.76"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@eslint/js": "^9.33.0",
|
||||||
|
"@types/node": "^24.3.0",
|
||||||
|
"eslint": "^9.33.0",
|
||||||
|
"eslint-config-prettier": "^10.1.8",
|
||||||
|
"globals": "^16.3.0",
|
||||||
|
"prettier": "^3.6.2",
|
||||||
|
"vitest": "^3.2.4"
|
||||||
|
}
|
||||||
|
}
|
||||||
93
src/index.js
Normal file
93
src/index.js
Normal file
@@ -0,0 +1,93 @@
|
|||||||
|
#!/usr/bin/env node
|
||||||
|
|
||||||
|
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
|
||||||
|
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
|
||||||
|
import {
|
||||||
|
CallToolRequestSchema,
|
||||||
|
ListToolsRequestSchema,
|
||||||
|
} from '@modelcontextprotocol/sdk/types.js';
|
||||||
|
import { timeTools } from './tools/index.js';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* MCP Time Server
|
||||||
|
* 提供时间相关工具的Model Context Protocol服务器
|
||||||
|
*/
|
||||||
|
class TimeServer {
|
||||||
|
constructor() {
|
||||||
|
this.server = new Server(
|
||||||
|
{
|
||||||
|
name: 'mcp-time-server',
|
||||||
|
version: '1.0.0',
|
||||||
|
},
|
||||||
|
{
|
||||||
|
capabilities: {
|
||||||
|
tools: {},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
);
|
||||||
|
|
||||||
|
this.setupHandlers();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 设置请求处理器
|
||||||
|
*/
|
||||||
|
setupHandlers() {
|
||||||
|
// 列出可用工具
|
||||||
|
this.server.setRequestHandler(ListToolsRequestSchema, async () => {
|
||||||
|
return {
|
||||||
|
tools: timeTools.map(tool => ({
|
||||||
|
name: tool.name,
|
||||||
|
description: tool.description,
|
||||||
|
inputSchema: tool.inputSchema,
|
||||||
|
})),
|
||||||
|
};
|
||||||
|
});
|
||||||
|
|
||||||
|
// 调用工具
|
||||||
|
this.server.setRequestHandler(CallToolRequestSchema, async request => {
|
||||||
|
const { name, arguments: args } = request.params;
|
||||||
|
|
||||||
|
const tool = timeTools.find(t => t.name === name);
|
||||||
|
if (!tool) {
|
||||||
|
throw new Error(`Unknown tool: ${name}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const result = await tool.handler(args || {});
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: 'text',
|
||||||
|
text: JSON.stringify(result, null, 2),
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
} catch (error) {
|
||||||
|
throw new Error(`Tool execution failed: ${error.message}`);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 启动服务器
|
||||||
|
*/
|
||||||
|
async start() {
|
||||||
|
const transport = new StdioServerTransport();
|
||||||
|
await this.server.connect(transport);
|
||||||
|
|
||||||
|
// 优雅关闭处理
|
||||||
|
process.on('SIGINT', async () => {
|
||||||
|
await this.server.close();
|
||||||
|
process.exit(0);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 启动服务器
|
||||||
|
if (import.meta.url === `file://${process.argv[1]}`) {
|
||||||
|
const server = new TimeServer();
|
||||||
|
server.start().catch(console.error);
|
||||||
|
}
|
||||||
|
|
||||||
|
export { TimeServer };
|
||||||
109
src/tools/current-time.js
Normal file
109
src/tools/current-time.js
Normal file
@@ -0,0 +1,109 @@
|
|||||||
|
import { z } from 'zod';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取当前时间工具
|
||||||
|
*/
|
||||||
|
export const getCurrentTime = {
|
||||||
|
name: 'getCurrentTime',
|
||||||
|
description: '获取当前时间，支持指定时区和格式',
|
||||||
|
inputSchema: {
|
||||||
|
type: 'object',
|
||||||
|
properties: {
|
||||||
|
timezone: {
|
||||||
|
type: 'string',
|
||||||
|
description: '时区标识符 (例如: Asia/Shanghai, America/New_York)',
|
||||||
|
default: 'UTC',
|
||||||
|
},
|
||||||
|
format: {
|
||||||
|
type: 'string',
|
||||||
|
description: '时间格式 (iso, timestamp, locale)',
|
||||||
|
enum: ['iso', 'timestamp', 'locale'],
|
||||||
|
default: 'iso',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
|
||||||
|
async handler(args) {
|
||||||
|
// 参数验证
|
||||||
|
const schema = z.object({
|
||||||
|
timezone: z.string().default('UTC'),
|
||||||
|
format: z.enum(['iso', 'timestamp', 'locale']).default('iso'),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { timezone, format } = schema.parse(args);
|
||||||
|
|
||||||
|
try {
|
||||||
|
const now = new Date();
|
||||||
|
|
||||||
|
// 验证时区
|
||||||
|
let formattedTime;
|
||||||
|
try {
|
||||||
|
if (format === 'iso') {
|
||||||
|
formattedTime =
|
||||||
|
now
|
||||||
|
.toLocaleString('sv-SE', {
|
||||||
|
timeZone: timezone,
|
||||||
|
year: 'numeric',
|
||||||
|
month: '2-digit',
|
||||||
|
day: '2-digit',
|
||||||
|
hour: '2-digit',
|
||||||
|
minute: '2-digit',
|
||||||
|
second: '2-digit',
|
||||||
|
hour12: false,
|
||||||
|
})
|
||||||
|
.replace(' ', 'T') + 'Z';
|
||||||
|
} else if (format === 'timestamp') {
|
||||||
|
formattedTime = Math.floor(now.getTime() / 1000);
|
||||||
|
} else {
|
||||||
|
formattedTime = now.toLocaleString('zh-CN', {
|
||||||
|
timeZone: timezone,
|
||||||
|
year: 'numeric',
|
||||||
|
month: '2-digit',
|
||||||
|
day: '2-digit',
|
||||||
|
hour: '2-digit',
|
||||||
|
minute: '2-digit',
|
||||||
|
second: '2-digit',
|
||||||
|
hour12: false,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
} catch {
|
||||||
|
throw new Error(`无效的时区: ${timezone}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: 'text',
|
||||||
|
text: JSON.stringify(
|
||||||
|
{
|
||||||
|
currentTime: formattedTime,
|
||||||
|
timezone,
|
||||||
|
format,
|
||||||
|
utcTime: now.toISOString(),
|
||||||
|
timestamp: Math.floor(now.getTime() / 1000),
|
||||||
|
},
|
||||||
|
null,
|
||||||
|
2
|
||||||
|
),
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
} catch (error) {
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: 'text',
|
||||||
|
text: JSON.stringify(
|
||||||
|
{
|
||||||
|
error: error.message,
|
||||||
|
},
|
||||||
|
null,
|
||||||
|
2
|
||||||
|
),
|
||||||
|
},
|
||||||
|
],
|
||||||
|
isError: true,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
},
|
||||||
|
};
|
||||||
250
src/tools/date-calculator.js
Normal file
250
src/tools/date-calculator.js
Normal file
@@ -0,0 +1,250 @@
|
|||||||
|
import { z } from 'zod';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 日期计算工具
|
||||||
|
*/
|
||||||
|
export const calculateDateDifference = {
|
||||||
|
name: 'calculateDateDifference',
|
||||||
|
description: '计算两个日期之间的差值，支持多种单位',
|
||||||
|
inputSchema: {
|
||||||
|
type: 'object',
|
||||||
|
properties: {
|
||||||
|
startDate: {
|
||||||
|
type: 'string',
|
||||||
|
description: '开始日期 (ISO格式或其他可解析格式)',
|
||||||
|
},
|
||||||
|
endDate: {
|
||||||
|
type: 'string',
|
||||||
|
description: '结束日期 (ISO格式或其他可解析格式)',
|
||||||
|
},
|
||||||
|
unit: {
|
||||||
|
type: 'string',
|
||||||
|
description: '计算单位',
|
||||||
|
enum: [
|
||||||
|
'years',
|
||||||
|
'months',
|
||||||
|
'days',
|
||||||
|
'hours',
|
||||||
|
'minutes',
|
||||||
|
'seconds',
|
||||||
|
'milliseconds',
|
||||||
|
],
|
||||||
|
default: 'days',
|
||||||
|
},
|
||||||
|
includeTime: {
|
||||||
|
type: 'boolean',
|
||||||
|
description: '是否包含时间部分',
|
||||||
|
default: true,
|
||||||
|
},
|
||||||
|
},
|
||||||
|
required: ['startDate', 'endDate'],
|
||||||
|
},
|
||||||
|
|
||||||
|
async handler(args) {
|
||||||
|
// 参数验证
|
||||||
|
const schema = z.object({
|
||||||
|
startDate: z.string(),
|
||||||
|
endDate: z.string(),
|
||||||
|
unit: z
|
||||||
|
.enum([
|
||||||
|
'years',
|
||||||
|
'months',
|
||||||
|
'days',
|
||||||
|
'hours',
|
||||||
|
'minutes',
|
||||||
|
'seconds',
|
||||||
|
'milliseconds',
|
||||||
|
])
|
||||||
|
.default('days'),
|
||||||
|
includeTime: z.boolean().default(true),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { startDate, endDate, unit, includeTime } = schema.parse(args);
|
||||||
|
|
||||||
|
try {
|
||||||
|
// 解析日期
|
||||||
|
const start = this.parseDate(startDate);
|
||||||
|
const end = this.parseDate(endDate);
|
||||||
|
|
||||||
|
if (isNaN(start.getTime()) || isNaN(end.getTime())) {
|
||||||
|
throw new Error('无效的日期格式');
|
||||||
|
}
|
||||||
|
|
||||||
|
// 如果不包含时间，则重置为当天开始
|
||||||
|
if (!includeTime) {
|
||||||
|
start.setHours(0, 0, 0, 0);
|
||||||
|
end.setHours(0, 0, 0, 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
const difference = this.calculateDifference(start, end, unit);
|
||||||
|
const absoluteDifference = Math.abs(difference);
|
||||||
|
|
||||||
|
// 计算详细信息
|
||||||
|
const detailedDiff = this.getDetailedDifference(start, end);
|
||||||
|
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: 'text',
|
||||||
|
text: JSON.stringify(
|
||||||
|
{
|
||||||
|
startDate: start.toISOString(),
|
||||||
|
endDate: end.toISOString(),
|
||||||
|
difference,
|
||||||
|
absoluteDifference,
|
||||||
|
unit,
|
||||||
|
isEndDateAfter: end > start,
|
||||||
|
detailed: detailedDiff,
|
||||||
|
humanReadable: this.formatHumanReadable(detailedDiff),
|
||||||
|
},
|
||||||
|
null,
|
||||||
|
2
|
||||||
|
),
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
} catch (error) {
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: 'text',
|
||||||
|
text: JSON.stringify(
|
||||||
|
{
|
||||||
|
error: error.message,
|
||||||
|
},
|
||||||
|
null,
|
||||||
|
2
|
||||||
|
),
|
||||||
|
},
|
||||||
|
],
|
||||||
|
isError: true,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
},
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 解析日期字符串
|
||||||
|
*/
|
||||||
|
parseDate(dateString) {
|
||||||
|
// 尝试解析时间戳
|
||||||
|
if (/^\d+$/.test(dateString)) {
|
||||||
|
const timestamp = parseInt(dateString);
|
||||||
|
return new Date(timestamp < 10000000000 ? timestamp * 1000 : timestamp);
|
||||||
|
}
|
||||||
|
|
||||||
|
return new Date(dateString);
|
||||||
|
},
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 计算指定单位的差值
|
||||||
|
*/
|
||||||
|
calculateDifference(start, end, unit) {
|
||||||
|
const diffMs = end.getTime() - start.getTime();
|
||||||
|
|
||||||
|
switch (unit) {
|
||||||
|
case 'milliseconds':
|
||||||
|
return diffMs;
|
||||||
|
case 'seconds':
|
||||||
|
return Math.floor(diffMs / 1000);
|
||||||
|
case 'minutes':
|
||||||
|
return Math.floor(diffMs / (1000 * 60));
|
||||||
|
case 'hours':
|
||||||
|
return Math.floor(diffMs / (1000 * 60 * 60));
|
||||||
|
case 'days':
|
||||||
|
return Math.floor(diffMs / (1000 * 60 * 60 * 24));
|
||||||
|
case 'months':
|
||||||
|
return this.calculateMonthDifference(start, end);
|
||||||
|
case 'years':
|
||||||
|
return this.calculateYearDifference(start, end);
|
||||||
|
default:
|
||||||
|
throw new Error(`不支持的单位: ${unit}`);
|
||||||
|
}
|
||||||
|
},
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 计算月份差值
|
||||||
|
*/
|
||||||
|
calculateMonthDifference(start, end) {
|
||||||
|
const yearDiff = end.getFullYear() - start.getFullYear();
|
||||||
|
const monthDiff = end.getMonth() - start.getMonth();
|
||||||
|
const dayDiff = end.getDate() - start.getDate();
|
||||||
|
|
||||||
|
let totalMonths = yearDiff * 12 + monthDiff;
|
||||||
|
|
||||||
|
// 如果结束日期的日期小于开始日期的日期，减去一个月
|
||||||
|
if (dayDiff < 0) {
|
||||||
|
totalMonths--;
|
||||||
|
}
|
||||||
|
|
||||||
|
return totalMonths;
|
||||||
|
},
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 计算年份差值
|
||||||
|
*/
|
||||||
|
calculateYearDifference(start, end) {
|
||||||
|
let years = end.getFullYear() - start.getFullYear();
|
||||||
|
|
||||||
|
// 检查是否还没到生日
|
||||||
|
if (
|
||||||
|
end.getMonth() < start.getMonth() ||
|
||||||
|
(end.getMonth() === start.getMonth() && end.getDate() < start.getDate())
|
||||||
|
) {
|
||||||
|
years--;
|
||||||
|
}
|
||||||
|
|
||||||
|
return years;
|
||||||
|
},
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取详细的差值信息
|
||||||
|
*/
|
||||||
|
getDetailedDifference(start, end) {
|
||||||
|
const diffMs = Math.abs(end.getTime() - start.getTime());
|
||||||
|
|
||||||
|
const years = Math.floor(diffMs / (1000 * 60 * 60 * 24 * 365.25));
|
||||||
|
const months = Math.floor(
|
||||||
|
(diffMs % (1000 * 60 * 60 * 24 * 365.25)) / (1000 * 60 * 60 * 24 * 30.44)
|
||||||
|
);
|
||||||
|
const days = Math.floor(
|
||||||
|
(diffMs % (1000 * 60 * 60 * 24 * 30.44)) / (1000 * 60 * 60 * 24)
|
||||||
|
);
|
||||||
|
const hours = Math.floor(
|
||||||
|
(diffMs % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60)
|
||||||
|
);
|
||||||
|
const minutes = Math.floor((diffMs % (1000 * 60 * 60)) / (1000 * 60));
|
||||||
|
const seconds = Math.floor((diffMs % (1000 * 60)) / 1000);
|
||||||
|
const milliseconds = diffMs % 1000;
|
||||||
|
|
||||||
|
return {
|
||||||
|
years,
|
||||||
|
months,
|
||||||
|
days,
|
||||||
|
hours,
|
||||||
|
minutes,
|
||||||
|
seconds,
|
||||||
|
milliseconds,
|
||||||
|
totalDays: Math.floor(diffMs / (1000 * 60 * 60 * 24)),
|
||||||
|
totalHours: Math.floor(diffMs / (1000 * 60 * 60)),
|
||||||
|
totalMinutes: Math.floor(diffMs / (1000 * 60)),
|
||||||
|
totalSeconds: Math.floor(diffMs / 1000),
|
||||||
|
totalMilliseconds: diffMs,
|
||||||
|
};
|
||||||
|
},
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 格式化为人类可读的字符串
|
||||||
|
*/
|
||||||
|
formatHumanReadable(detailed) {
|
||||||
|
const parts = [];
|
||||||
|
|
||||||
|
if (detailed.years > 0) parts.push(`${detailed.years}年`);
|
||||||
|
if (detailed.months > 0) parts.push(`${detailed.months}个月`);
|
||||||
|
if (detailed.days > 0) parts.push(`${detailed.days}天`);
|
||||||
|
if (detailed.hours > 0) parts.push(`${detailed.hours}小时`);
|
||||||
|
if (detailed.minutes > 0) parts.push(`${detailed.minutes}分钟`);
|
||||||
|
if (detailed.seconds > 0) parts.push(`${detailed.seconds}秒`);
|
||||||
|
|
||||||
|
return parts.length > 0 ? parts.join(' ') : '0秒';
|
||||||
|
},
|
||||||
|
};
|
||||||
189
src/tools/format-time.js
Normal file
189
src/tools/format-time.js
Normal file
@@ -0,0 +1,189 @@
|
|||||||
|
import { z } from 'zod';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 时间格式化工具
|
||||||
|
*/
|
||||||
|
export const formatTime = {
|
||||||
|
name: 'formatTime',
|
||||||
|
description: '格式化时间为指定格式',
|
||||||
|
inputSchema: {
|
||||||
|
type: 'object',
|
||||||
|
properties: {
|
||||||
|
time: {
|
||||||
|
type: 'string',
|
||||||
|
description: '要格式化的时间 (ISO格式、时间戳或其他可解析格式)',
|
||||||
|
},
|
||||||
|
format: {
|
||||||
|
type: 'string',
|
||||||
|
description: '输出格式 (iso, timestamp, locale, custom)',
|
||||||
|
enum: ['iso', 'timestamp', 'locale', 'custom'],
|
||||||
|
default: 'iso',
|
||||||
|
},
|
||||||
|
timezone: {
|
||||||
|
type: 'string',
|
||||||
|
description: '目标时区',
|
||||||
|
default: 'UTC',
|
||||||
|
},
|
||||||
|
customFormat: {
|
||||||
|
type: 'string',
|
||||||
|
description: '自定义格式模板 (当format为custom时使用)',
|
||||||
|
},
|
||||||
|
locale: {
|
||||||
|
type: 'string',
|
||||||
|
description: '本地化语言代码',
|
||||||
|
default: 'zh-CN',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
required: ['time'],
|
||||||
|
},
|
||||||
|
|
||||||
|
async handler(args) {
|
||||||
|
// 参数验证
|
||||||
|
const schema = z.object({
|
||||||
|
time: z.string(),
|
||||||
|
format: z.enum(['iso', 'timestamp', 'locale', 'custom']).default('iso'),
|
||||||
|
timezone: z.string().default('UTC'),
|
||||||
|
customFormat: z.string().optional(),
|
||||||
|
locale: z.string().default('zh-CN'),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { time, format, timezone, customFormat, locale } = schema.parse(args);
|
||||||
|
|
||||||
|
try {
|
||||||
|
// 解析输入时间
|
||||||
|
let date;
|
||||||
|
if (/^\d+$/.test(time)) {
|
||||||
|
// 时间戳（秒或毫秒）
|
||||||
|
const timestamp = parseInt(time);
|
||||||
|
date = new Date(timestamp < 10000000000 ? timestamp * 1000 : timestamp);
|
||||||
|
} else {
|
||||||
|
date = new Date(time);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (isNaN(date.getTime())) {
|
||||||
|
throw new Error('无效的时间格式');
|
||||||
|
}
|
||||||
|
|
||||||
|
let formattedTime;
|
||||||
|
|
||||||
|
try {
|
||||||
|
switch (format) {
|
||||||
|
case 'iso':
|
||||||
|
formattedTime =
|
||||||
|
date
|
||||||
|
.toLocaleString('sv-SE', {
|
||||||
|
timeZone: timezone,
|
||||||
|
year: 'numeric',
|
||||||
|
month: '2-digit',
|
||||||
|
day: '2-digit',
|
||||||
|
hour: '2-digit',
|
||||||
|
minute: '2-digit',
|
||||||
|
second: '2-digit',
|
||||||
|
hour12: false,
|
||||||
|
})
|
||||||
|
.replace(' ', 'T') + 'Z';
|
||||||
|
break;
|
||||||
|
|
||||||
|
case 'timestamp':
|
||||||
|
formattedTime = Math.floor(date.getTime() / 1000);
|
||||||
|
break;
|
||||||
|
|
||||||
|
case 'locale':
|
||||||
|
formattedTime = date.toLocaleString(locale, {
|
||||||
|
timeZone: timezone,
|
||||||
|
year: 'numeric',
|
||||||
|
month: '2-digit',
|
||||||
|
day: '2-digit',
|
||||||
|
hour: '2-digit',
|
||||||
|
minute: '2-digit',
|
||||||
|
second: '2-digit',
|
||||||
|
hour12: false,
|
||||||
|
});
|
||||||
|
break;
|
||||||
|
|
||||||
|
case 'custom':
|
||||||
|
if (!customFormat) {
|
||||||
|
throw new Error('自定义格式需要提供customFormat参数');
|
||||||
|
}
|
||||||
|
formattedTime = this.formatCustom(date, customFormat, timezone);
|
||||||
|
break;
|
||||||
|
|
||||||
|
default:
|
||||||
|
throw new Error(`不支持的格式: ${format}`);
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
if (error.message.includes('Invalid time zone')) {
|
||||||
|
throw new Error(`无效的时区: ${timezone}`);
|
||||||
|
}
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: 'text',
|
||||||
|
text: JSON.stringify(
|
||||||
|
{
|
||||||
|
originalTime: time,
|
||||||
|
formattedTime,
|
||||||
|
format,
|
||||||
|
timezone,
|
||||||
|
locale,
|
||||||
|
utcTime: date.toISOString(),
|
||||||
|
timestamp: Math.floor(date.getTime() / 1000),
|
||||||
|
},
|
||||||
|
null,
|
||||||
|
2
|
||||||
|
),
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
} catch (error) {
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: 'text',
|
||||||
|
text: JSON.stringify(
|
||||||
|
{
|
||||||
|
error: error.message,
|
||||||
|
},
|
||||||
|
null,
|
||||||
|
2
|
||||||
|
),
|
||||||
|
},
|
||||||
|
],
|
||||||
|
isError: true,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
},
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 自定义格式化
|
||||||
|
*/
|
||||||
|
formatCustom(date, format, timezone) {
|
||||||
|
const options = {
|
||||||
|
timeZone: timezone,
|
||||||
|
year: 'numeric',
|
||||||
|
month: '2-digit',
|
||||||
|
day: '2-digit',
|
||||||
|
hour: '2-digit',
|
||||||
|
minute: '2-digit',
|
||||||
|
second: '2-digit',
|
||||||
|
hour12: false,
|
||||||
|
};
|
||||||
|
|
||||||
|
const parts = new Intl.DateTimeFormat('en-CA', options).formatToParts(date);
|
||||||
|
const partMap = {};
|
||||||
|
parts.forEach(part => {
|
||||||
|
partMap[part.type] = part.value;
|
||||||
|
});
|
||||||
|
|
||||||
|
return format
|
||||||
|
.replace(/YYYY/g, partMap.year)
|
||||||
|
.replace(/MM/g, partMap.month)
|
||||||
|
.replace(/DD/g, partMap.day)
|
||||||
|
.replace(/HH/g, partMap.hour)
|
||||||
|
.replace(/mm/g, partMap.minute)
|
||||||
|
.replace(/ss/g, partMap.second);
|
||||||
|
},
|
||||||
|
};
|
||||||
24
src/tools/index.js
Normal file
24
src/tools/index.js
Normal file
@@ -0,0 +1,24 @@
|
|||||||
|
import { getCurrentTime } from './current-time.js';
|
||||||
|
import { getTimezone } from './timezone.js';
|
||||||
|
import { formatTime } from './format-time.js';
|
||||||
|
import { calculateDateDifference } from './date-calculator.js';
|
||||||
|
import { getWorldClock } from './world-clock.js';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 所有可用的时间工具
|
||||||
|
*/
|
||||||
|
export const timeTools = [
|
||||||
|
getCurrentTime,
|
||||||
|
getTimezone,
|
||||||
|
formatTime,
|
||||||
|
calculateDateDifference,
|
||||||
|
getWorldClock,
|
||||||
|
];
|
||||||
|
|
||||||
|
export {
|
||||||
|
getCurrentTime,
|
||||||
|
getTimezone,
|
||||||
|
formatTime,
|
||||||
|
calculateDateDifference,
|
||||||
|
getWorldClock,
|
||||||
|
};
|
||||||
163
src/tools/timezone.js
Normal file
163
src/tools/timezone.js
Normal file
@@ -0,0 +1,163 @@
|
|||||||
|
import { z } from 'zod';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 时区信息工具
|
||||||
|
*/
|
||||||
|
export const getTimezone = {
|
||||||
|
name: 'getTimezone',
|
||||||
|
description: '获取时区信息，包括偏移量、缩写等',
|
||||||
|
inputSchema: {
|
||||||
|
type: 'object',
|
||||||
|
properties: {
|
||||||
|
timezone: {
|
||||||
|
type: 'string',
|
||||||
|
description: '时区标识符 (例如: Asia/Shanghai, America/New_York)',
|
||||||
|
default: 'UTC',
|
||||||
|
},
|
||||||
|
date: {
|
||||||
|
type: 'string',
|
||||||
|
description: '指定日期 (ISO格式), 默认为当前时间',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
|
||||||
|
async handler(args) {
|
||||||
|
// 参数验证
|
||||||
|
const schema = z.object({
|
||||||
|
timezone: z.string().default('UTC'),
|
||||||
|
date: z.string().optional(),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { timezone, date } = schema.parse(args);
|
||||||
|
|
||||||
|
try {
|
||||||
|
const targetDate = date ? new Date(date) : new Date();
|
||||||
|
|
||||||
|
if (isNaN(targetDate.getTime())) {
|
||||||
|
throw new Error('无效的日期格式');
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证时区并获取信息
|
||||||
|
let timezoneInfo;
|
||||||
|
try {
|
||||||
|
// 获取时区偏移量
|
||||||
|
const utcTime = targetDate.getTime();
|
||||||
|
const localTime = new Date(
|
||||||
|
targetDate.toLocaleString('en-US', { timeZone: timezone })
|
||||||
|
).getTime();
|
||||||
|
const offset = (localTime - utcTime) / (1000 * 60 * 60);
|
||||||
|
|
||||||
|
// 获取时区缩写
|
||||||
|
const formatter = new Intl.DateTimeFormat('en', {
|
||||||
|
timeZone: timezone,
|
||||||
|
timeZoneName: 'short',
|
||||||
|
});
|
||||||
|
const parts = formatter.formatToParts(targetDate);
|
||||||
|
const abbreviation =
|
||||||
|
parts.find(part => part.type === 'timeZoneName')?.value || '';
|
||||||
|
|
||||||
|
// 获取长格式名称
|
||||||
|
const longFormatter = new Intl.DateTimeFormat('en', {
|
||||||
|
timeZone: timezone,
|
||||||
|
timeZoneName: 'long',
|
||||||
|
});
|
||||||
|
const longParts = longFormatter.formatToParts(targetDate);
|
||||||
|
const longName =
|
||||||
|
longParts.find(part => part.type === 'timeZoneName')?.value || '';
|
||||||
|
|
||||||
|
timezoneInfo = {
|
||||||
|
timezone,
|
||||||
|
offset,
|
||||||
|
offsetString: `UTC${offset >= 0 ? '+' : ''}${offset}`,
|
||||||
|
abbreviation,
|
||||||
|
longName,
|
||||||
|
isDST: this.isDaylightSavingTime(targetDate, timezone),
|
||||||
|
};
|
||||||
|
} catch {
|
||||||
|
throw new Error(`无效的时区: ${timezone}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: 'text',
|
||||||
|
text: JSON.stringify(
|
||||||
|
{
|
||||||
|
...timezoneInfo,
|
||||||
|
date: targetDate.toISOString(),
|
||||||
|
localTime: targetDate.toLocaleString('zh-CN', {
|
||||||
|
timeZone: timezone,
|
||||||
|
year: 'numeric',
|
||||||
|
month: '2-digit',
|
||||||
|
day: '2-digit',
|
||||||
|
hour: '2-digit',
|
||||||
|
minute: '2-digit',
|
||||||
|
second: '2-digit',
|
||||||
|
hour12: false,
|
||||||
|
}),
|
||||||
|
},
|
||||||
|
null,
|
||||||
|
2
|
||||||
|
),
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
} catch (error) {
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: 'text',
|
||||||
|
text: JSON.stringify(
|
||||||
|
{
|
||||||
|
error: error.message,
|
||||||
|
},
|
||||||
|
null,
|
||||||
|
2
|
||||||
|
),
|
||||||
|
},
|
||||||
|
],
|
||||||
|
isError: true,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
},
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查是否为夏令时
|
||||||
|
*/
|
||||||
|
isDaylightSavingTime(date, timezone) {
|
||||||
|
try {
|
||||||
|
const jan = new Date(date.getFullYear(), 0, 1);
|
||||||
|
const jul = new Date(date.getFullYear(), 6, 1);
|
||||||
|
|
||||||
|
const janOffset = this.getTimezoneOffset(jan, timezone);
|
||||||
|
const julOffset = this.getTimezoneOffset(jul, timezone);
|
||||||
|
const currentOffset = this.getTimezoneOffset(date, timezone);
|
||||||
|
|
||||||
|
return currentOffset !== Math.max(janOffset, julOffset);
|
||||||
|
} catch {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
},
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取时区偏移量（分钟）
|
||||||
|
*/
|
||||||
|
getTimezoneOffset(date, timezone) {
|
||||||
|
const utc = date.getTime() + date.getTimezoneOffset() * 60000;
|
||||||
|
const local = new Date(
|
||||||
|
utc + this.getTimezoneOffsetHours(date, timezone) * 3600000
|
||||||
|
);
|
||||||
|
return (local.getTime() - utc) / 60000;
|
||||||
|
},
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取时区偏移量（小时）
|
||||||
|
*/
|
||||||
|
getTimezoneOffsetHours(date, timezone) {
|
||||||
|
const utcTime = date.getTime();
|
||||||
|
const localTime = new Date(
|
||||||
|
date.toLocaleString('en-US', { timeZone: timezone })
|
||||||
|
).getTime();
|
||||||
|
return (localTime - utcTime) / (1000 * 60 * 60);
|
||||||
|
},
|
||||||
|
};
|
||||||
277
src/tools/world-clock.js
Normal file
277
src/tools/world-clock.js
Normal file
@@ -0,0 +1,277 @@
|
|||||||
|
import { z } from 'zod';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 世界时钟工具
|
||||||
|
*/
|
||||||
|
export const getWorldClock = {
|
||||||
|
name: 'getWorldClock',
|
||||||
|
description: '获取多个时区的当前时间',
|
||||||
|
inputSchema: {
|
||||||
|
type: 'object',
|
||||||
|
properties: {
|
||||||
|
timezones: {
|
||||||
|
type: 'array',
|
||||||
|
items: {
|
||||||
|
type: 'string',
|
||||||
|
},
|
||||||
|
description:
|
||||||
|
'时区列表 (例如: ["Asia/Shanghai", "America/New_York", "Europe/London"])',
|
||||||
|
default: ['UTC', 'Asia/Shanghai', 'America/New_York', 'Europe/London'],
|
||||||
|
},
|
||||||
|
format: {
|
||||||
|
type: 'string',
|
||||||
|
description: '时间格式',
|
||||||
|
enum: ['iso', 'locale', 'custom'],
|
||||||
|
default: 'locale',
|
||||||
|
},
|
||||||
|
customFormat: {
|
||||||
|
type: 'string',
|
||||||
|
description: '自定义格式模板 (当format为custom时使用)',
|
||||||
|
},
|
||||||
|
includeOffset: {
|
||||||
|
type: 'boolean',
|
||||||
|
description: '是否包含UTC偏移量信息',
|
||||||
|
default: true,
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
|
||||||
|
async handler(args) {
|
||||||
|
// 参数验证
|
||||||
|
const schema = z.object({
|
||||||
|
timezones: z
|
||||||
|
.array(z.string())
|
||||||
|
.default(['UTC', 'Asia/Shanghai', 'America/New_York', 'Europe/London']),
|
||||||
|
format: z.enum(['iso', 'locale', 'custom']).default('locale'),
|
||||||
|
customFormat: z.string().optional(),
|
||||||
|
includeOffset: z.boolean().default(true),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { timezones, format, customFormat, includeOffset } =
|
||||||
|
schema.parse(args);
|
||||||
|
|
||||||
|
try {
|
||||||
|
const now = new Date();
|
||||||
|
const worldTimes = [];
|
||||||
|
const errors = [];
|
||||||
|
|
||||||
|
for (const timezone of timezones) {
|
||||||
|
try {
|
||||||
|
const timeInfo = await this.getTimezoneTime(
|
||||||
|
now,
|
||||||
|
timezone,
|
||||||
|
format,
|
||||||
|
customFormat,
|
||||||
|
includeOffset
|
||||||
|
);
|
||||||
|
worldTimes.push(timeInfo);
|
||||||
|
} catch (error) {
|
||||||
|
errors.push({
|
||||||
|
timezone,
|
||||||
|
error: error.message,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: 'text',
|
||||||
|
text: JSON.stringify(
|
||||||
|
{
|
||||||
|
timestamp: Math.floor(now.getTime() / 1000),
|
||||||
|
utcTime: now.toISOString(),
|
||||||
|
worldClock: worldTimes,
|
||||||
|
errors: errors.length > 0 ? errors : undefined,
|
||||||
|
totalTimezones: timezones.length,
|
||||||
|
successfulTimezones: worldTimes.length,
|
||||||
|
},
|
||||||
|
null,
|
||||||
|
2
|
||||||
|
),
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
} catch (error) {
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: 'text',
|
||||||
|
text: JSON.stringify(
|
||||||
|
{
|
||||||
|
error: error.message,
|
||||||
|
},
|
||||||
|
null,
|
||||||
|
2
|
||||||
|
),
|
||||||
|
},
|
||||||
|
],
|
||||||
|
isError: true,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
},
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取指定时区的时间信息
|
||||||
|
*/
|
||||||
|
async getTimezoneTime(date, timezone, format, customFormat, includeOffset) {
|
||||||
|
try {
|
||||||
|
let formattedTime;
|
||||||
|
|
||||||
|
switch (format) {
|
||||||
|
case 'iso':
|
||||||
|
formattedTime =
|
||||||
|
date
|
||||||
|
.toLocaleString('sv-SE', {
|
||||||
|
timeZone: timezone,
|
||||||
|
year: 'numeric',
|
||||||
|
month: '2-digit',
|
||||||
|
day: '2-digit',
|
||||||
|
hour: '2-digit',
|
||||||
|
minute: '2-digit',
|
||||||
|
second: '2-digit',
|
||||||
|
hour12: false,
|
||||||
|
})
|
||||||
|
.replace(' ', 'T') + 'Z';
|
||||||
|
break;
|
||||||
|
|
||||||
|
case 'locale':
|
||||||
|
formattedTime = date.toLocaleString('zh-CN', {
|
||||||
|
timeZone: timezone,
|
||||||
|
year: 'numeric',
|
||||||
|
month: '2-digit',
|
||||||
|
day: '2-digit',
|
||||||
|
hour: '2-digit',
|
||||||
|
minute: '2-digit',
|
||||||
|
second: '2-digit',
|
||||||
|
hour12: false,
|
||||||
|
weekday: 'long',
|
||||||
|
});
|
||||||
|
break;
|
||||||
|
|
||||||
|
case 'custom':
|
||||||
|
if (!customFormat) {
|
||||||
|
throw new Error('自定义格式需要提供customFormat参数');
|
||||||
|
}
|
||||||
|
formattedTime = this.formatCustom(date, customFormat, timezone);
|
||||||
|
break;
|
||||||
|
|
||||||
|
default:
|
||||||
|
throw new Error(`不支持的格式: ${format}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
const result = {
|
||||||
|
timezone,
|
||||||
|
time: formattedTime,
|
||||||
|
format,
|
||||||
|
};
|
||||||
|
|
||||||
|
if (includeOffset) {
|
||||||
|
const offsetInfo = this.getTimezoneOffset(date, timezone);
|
||||||
|
result.offset = offsetInfo;
|
||||||
|
}
|
||||||
|
|
||||||
|
return result;
|
||||||
|
} catch (error) {
|
||||||
|
throw new Error(`时区 ${timezone} 处理失败: ${error.message}`);
|
||||||
|
}
|
||||||
|
},
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取时区偏移信息
|
||||||
|
*/
|
||||||
|
getTimezoneOffset(date, timezone) {
|
||||||
|
try {
|
||||||
|
// 获取UTC时间和本地时间的差值
|
||||||
|
const utcTime = date.getTime();
|
||||||
|
const localTime = new Date(
|
||||||
|
date.toLocaleString('en-US', { timeZone: timezone })
|
||||||
|
).getTime();
|
||||||
|
const offsetMs = localTime - utcTime;
|
||||||
|
const offsetHours = offsetMs / (1000 * 60 * 60);
|
||||||
|
|
||||||
|
// 获取时区缩写
|
||||||
|
const formatter = new Intl.DateTimeFormat('en', {
|
||||||
|
timeZone: timezone,
|
||||||
|
timeZoneName: 'short',
|
||||||
|
});
|
||||||
|
const parts = formatter.formatToParts(date);
|
||||||
|
const abbreviation =
|
||||||
|
parts.find(part => part.type === 'timeZoneName')?.value || '';
|
||||||
|
|
||||||
|
return {
|
||||||
|
hours: offsetHours,
|
||||||
|
string: `UTC${offsetHours >= 0 ? '+' : ''}${offsetHours}`,
|
||||||
|
abbreviation,
|
||||||
|
isDST: this.isDaylightSavingTime(date, timezone),
|
||||||
|
};
|
||||||
|
} catch (error) {
|
||||||
|
return {
|
||||||
|
hours: 0,
|
||||||
|
string: 'UTC+0',
|
||||||
|
abbreviation: '',
|
||||||
|
isDST: false,
|
||||||
|
error: error.message,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
},
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查是否为夏令时
|
||||||
|
*/
|
||||||
|
isDaylightSavingTime(date, timezone) {
|
||||||
|
try {
|
||||||
|
const jan = new Date(date.getFullYear(), 0, 1);
|
||||||
|
const jul = new Date(date.getFullYear(), 6, 1);
|
||||||
|
|
||||||
|
const janOffset = this.getTimezoneOffsetHours(jan, timezone);
|
||||||
|
const julOffset = this.getTimezoneOffsetHours(jul, timezone);
|
||||||
|
const currentOffset = this.getTimezoneOffsetHours(date, timezone);
|
||||||
|
|
||||||
|
return currentOffset !== Math.max(janOffset, julOffset);
|
||||||
|
} catch {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
},
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取时区偏移量（小时）
|
||||||
|
*/
|
||||||
|
getTimezoneOffsetHours(date, timezone) {
|
||||||
|
const utcTime = date.getTime();
|
||||||
|
const localTime = new Date(
|
||||||
|
date.toLocaleString('en-US', { timeZone: timezone })
|
||||||
|
).getTime();
|
||||||
|
return (localTime - utcTime) / (1000 * 60 * 60);
|
||||||
|
},
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 自定义格式化
|
||||||
|
*/
|
||||||
|
formatCustom(date, format, timezone) {
|
||||||
|
const options = {
|
||||||
|
timeZone: timezone,
|
||||||
|
year: 'numeric',
|
||||||
|
month: '2-digit',
|
||||||
|
day: '2-digit',
|
||||||
|
hour: '2-digit',
|
||||||
|
minute: '2-digit',
|
||||||
|
second: '2-digit',
|
||||||
|
hour12: false,
|
||||||
|
};
|
||||||
|
|
||||||
|
const parts = new Intl.DateTimeFormat('en-CA', options).formatToParts(date);
|
||||||
|
const partMap = {};
|
||||||
|
parts.forEach(part => {
|
||||||
|
partMap[part.type] = part.value;
|
||||||
|
});
|
||||||
|
|
||||||
|
return format
|
||||||
|
.replace(/YYYY/g, partMap.year)
|
||||||
|
.replace(/MM/g, partMap.month)
|
||||||
|
.replace(/DD/g, partMap.day)
|
||||||
|
.replace(/HH/g, partMap.hour)
|
||||||
|
.replace(/mm/g, partMap.minute)
|
||||||
|
.replace(/ss/g, partMap.second);
|
||||||
|
},
|
||||||
|
};
|
||||||
135
tests/time-tools.test.js
Normal file
135
tests/time-tools.test.js
Normal file
@@ -0,0 +1,135 @@
|
|||||||
|
import { describe, it, expect } from 'vitest';
|
||||||
|
import { timeTools } from '../src/tools/index.js';
|
||||||
|
|
||||||
|
describe('Time Tools', () => {
|
||||||
|
describe('getCurrentTime', () => {
|
||||||
|
it('should return current time in ISO format by default', async () => {
|
||||||
|
const getCurrentTime = timeTools.find(
|
||||||
|
tool => tool.name === 'getCurrentTime'
|
||||||
|
);
|
||||||
|
expect(getCurrentTime).toBeDefined();
|
||||||
|
|
||||||
|
const result = await getCurrentTime.handler({});
|
||||||
|
expect(result).toHaveProperty('content');
|
||||||
|
expect(result.content[0]).toHaveProperty('text');
|
||||||
|
|
||||||
|
const response = JSON.parse(result.content[0].text);
|
||||||
|
expect(response).toHaveProperty('currentTime');
|
||||||
|
expect(response).toHaveProperty('timezone');
|
||||||
|
expect(response).toHaveProperty('format');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should return time in specified timezone', async () => {
|
||||||
|
const getCurrentTime = timeTools.find(
|
||||||
|
tool => tool.name === 'getCurrentTime'
|
||||||
|
);
|
||||||
|
const result = await getCurrentTime.handler({
|
||||||
|
timezone: 'America/New_York',
|
||||||
|
});
|
||||||
|
|
||||||
|
const response = JSON.parse(result.content[0].text);
|
||||||
|
expect(response.timezone).toBe('America/New_York');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('getTimezone', () => {
|
||||||
|
it('should return timezone information', async () => {
|
||||||
|
const getTimezone = timeTools.find(tool => tool.name === 'getTimezone');
|
||||||
|
expect(getTimezone).toBeDefined();
|
||||||
|
|
||||||
|
const result = await getTimezone.handler({ timezone: 'UTC' });
|
||||||
|
const response = JSON.parse(result.content[0].text);
|
||||||
|
|
||||||
|
expect(response).toHaveProperty('timezone');
|
||||||
|
expect(response).toHaveProperty('offset');
|
||||||
|
expect(response).toHaveProperty('abbreviation');
|
||||||
|
expect(response).toHaveProperty('longName');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('formatTime', () => {
|
||||||
|
it('should format time correctly', async () => {
|
||||||
|
const formatTime = timeTools.find(tool => tool.name === 'formatTime');
|
||||||
|
expect(formatTime).toBeDefined();
|
||||||
|
|
||||||
|
const testDate = '2024-01-01T12:00:00Z';
|
||||||
|
const result = await formatTime.handler({
|
||||||
|
time: testDate,
|
||||||
|
format: 'iso',
|
||||||
|
});
|
||||||
|
|
||||||
|
const response = JSON.parse(result.content[0].text);
|
||||||
|
expect(response).toHaveProperty('originalTime');
|
||||||
|
expect(response).toHaveProperty('formattedTime');
|
||||||
|
expect(response).toHaveProperty('format');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('calculateDateDifference', () => {
|
||||||
|
it('should calculate date difference correctly', async () => {
|
||||||
|
const calculateDateDifference = timeTools.find(
|
||||||
|
tool => tool.name === 'calculateDateDifference'
|
||||||
|
);
|
||||||
|
expect(calculateDateDifference).toBeDefined();
|
||||||
|
|
||||||
|
const result = await calculateDateDifference.handler({
|
||||||
|
startDate: '2024-01-01',
|
||||||
|
endDate: '2024-01-02',
|
||||||
|
unit: 'days',
|
||||||
|
});
|
||||||
|
|
||||||
|
const response = JSON.parse(result.content[0].text);
|
||||||
|
expect(response).toHaveProperty('startDate');
|
||||||
|
expect(response).toHaveProperty('endDate');
|
||||||
|
expect(response).toHaveProperty('difference');
|
||||||
|
expect(response.difference).toBe(1);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('getWorldClock', () => {
|
||||||
|
it('should return world clock information', async () => {
|
||||||
|
const getWorldClock = timeTools.find(
|
||||||
|
tool => tool.name === 'getWorldClock'
|
||||||
|
);
|
||||||
|
expect(getWorldClock).toBeDefined();
|
||||||
|
|
||||||
|
const result = await getWorldClock.handler({
|
||||||
|
timezones: ['UTC', 'America/New_York'],
|
||||||
|
});
|
||||||
|
|
||||||
|
const response = JSON.parse(result.content[0].text);
|
||||||
|
expect(response).toHaveProperty('worldClock');
|
||||||
|
expect(Array.isArray(response.worldClock)).toBe(true);
|
||||||
|
expect(response.worldClock).toHaveLength(2);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('Tool Validation', () => {
|
||||||
|
it('should have all required tools', () => {
|
||||||
|
const expectedTools = [
|
||||||
|
'getCurrentTime',
|
||||||
|
'getTimezone',
|
||||||
|
'formatTime',
|
||||||
|
'calculateDateDifference',
|
||||||
|
'getWorldClock',
|
||||||
|
];
|
||||||
|
|
||||||
|
expectedTools.forEach(toolName => {
|
||||||
|
const tool = timeTools.find(t => t.name === toolName);
|
||||||
|
expect(tool).toBeDefined();
|
||||||
|
expect(tool).toHaveProperty('name');
|
||||||
|
expect(tool).toHaveProperty('description');
|
||||||
|
expect(tool).toHaveProperty('inputSchema');
|
||||||
|
expect(tool).toHaveProperty('handler');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should have valid input schemas', () => {
|
||||||
|
timeTools.forEach(tool => {
|
||||||
|
expect(tool.inputSchema).toHaveProperty('type');
|
||||||
|
expect(tool.inputSchema.type).toBe('object');
|
||||||
|
expect(tool.inputSchema).toHaveProperty('properties');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
18
vitest.config.js
Normal file
18
vitest.config.js
Normal file
@@ -0,0 +1,18 @@
|
|||||||
|
import { defineConfig } from 'vitest/config';
|
||||||
|
|
||||||
|
export default defineConfig({
|
||||||
|
test: {
|
||||||
|
globals: true,
|
||||||
|
environment: 'node',
|
||||||
|
coverage: {
|
||||||
|
provider: 'v8',
|
||||||
|
reporter: ['text', 'json', 'html'],
|
||||||
|
exclude: [
|
||||||
|
'node_modules/',
|
||||||
|
'tests/',
|
||||||
|
'bin/',
|
||||||
|
'*.config.js',
|
||||||
|
],
|
||||||
|
},
|
||||||
|
},
|
||||||
|
});
|
||||||
Reference in New Issue
Block a user