MCP Node Time

时间节点MCP服务器

提供时区感知日期和时间操作的模型上下文协议（MCP）服务器。该服务器解决了AI助手由于时区混淆而提供不正确日期信息的常见问题。

特性

• 精确的时区处理 -获取任何IANA时区的当前时间
• 时间转换 -在不同时区之间转换时间
• 多种格式 -ISO 8601，本地化和人类可读格式
• 系统时区检测 -自动检测系统时区
• DST意识 -正确处理夏令时转换
• 日期实用程序 -获取当前日期和星期几信息

安装

先决条件

• Node.js 18.0.0或更高版本
• npm或纱线

安装和构建

# Clone or download the project
cd time-node-mcp

# Install dependencies
npm install

# Build the TypeScript code
npm run build

使用Claude Desktop

将以下配置添加到您的Claude Desktop设置文件中：

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

视窗

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "time-node-mcp": {
      "command": "node",
      "args": ["/path/to/time-node-mcp/dist/index.js"]
    }
  }
}

替换 /path/to/time-node-mcp/ 带有安装目录的实际路径。

可用工具

1.get_current_time

获取特定时区的当前日期和时间。

参数：

• timezone （必填）：IANA时区标识符（例如，“美洲/纽约”、“欧洲/伦敦”）
• format （可选）：输出格式-“iso”、“local”或“full”（默认：“iso”）

例子：

{
  "timezone": "America/New_York",
  "format": "full"
}

2.转换时间

将时间从一个时区转换为另一个时区。

参数：

• sourceTimezone （必填）：源IANA时区标识符
• targetTimezone （必填）：目标IANA时区标识符
• time （必填）：HH:MM或HH:MM:SS格式的时间（24小时）
• date （可选）：YYYY-MM-DD格式的日期（如果未提供，则使用当前日期）

例子：

{
  "sourceTimezone": "America/New_York",
  "targetTimezone": "Europe/London",
  "time": "14:30",
  "date": "2024-08-12"
}

3.get_system_timezone

使用当前时间信息获取系统的当前时区。

参数： 无

4.get_current_date

获取特定时区的当前日期和星期几信息。

参数：

• timezone （必填）：IANA时区标识符
• includeTime （可选）：是否包含时间信息（默认：false）

例子：

{
  "timezone": "Asia/Tokyo",
  "includeTime": true
}

发展

脚本

# Build the project
npm run build

# Build and watch for changes
npm run dev

# Run the server directly (after building)
npm start

# Lint the code
npm run lint

# Type check
npm run typecheck

项目结构

time-node-mcp/
├── src/
│   ├── index.ts           # Main MCP server implementation
│   ├── time-service.ts    # Core time/timezone functionality
│   └── interfaces.ts      # TypeScript interfaces
├── dist/                  # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.md

常见用例

1. 正确的当前日期/时间：当克劳德需要知道你所在时区的“今天是几号”时
2. 会议日程安排：在不同时区之间转换会议时间
3. 旅行计划：了解旅行时的时差
4. 国际协调：与跨越多个时区的团队合作

时区支持

此服务器支持所有IANA时区标识符，包括：

• America/New_York
• Europe/London
• Asia/Tokyo
• Australia/Sydney
• Pacific/Auckland
• 还有更多。..

您可以在以下网址找到支持的时区的完整列表：https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

错误处理

服务器为以下内容提供全面的错误处理：

• 时区标识符无效
• 时间格式不正确
• 日期格式无效
• 系统错误

所有错误都以结构化JSON格式返回，并带有描述性消息。

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 运行测试和梳理
5. 提交拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

故障排除

常见问题

“时区无效”错误：

• 确保您使用的是有效的IANA时区标识符
• 检查拼写和大小写（例如，“America/New_York”，而不是“America/New_York”）

MCP服务器未连接：

• 验证Claude Desktop配置中的路径是否正确
• 确保项目建成(npm run build)
• 检查Node.js是否已安装且可访问

日期/时间似乎不正确：

• 服务器使用您系统的当前日期/时间作为基础
• 确保您的系统时钟正确，时区设置正确