AI导哈

时区时间服务器

一个提供时区感知时间操作和自然语言解析功能的时间服务器。

  • by fifthseason-ai
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 fifthseason-ai/time-mcp

使用说明

时间MCP服务器

一种模型上下文协议（MCP）服务器，提供具有自然语言解析功能的时区感知时间操作。

特性

  • 当前时间：获取任何时区的当前时间
  • 自然语言解析：解析“下周二”、“30天后”、“明天下午3点”等表达式
  • 时间计算：计算时间差
  • 时区转换：转换不同时区之间的时间
  • 时区信息：获取详细的时区信息

工具

1.get_current_time

获取用户时区中的当前时间。

参数：

  • timezone （可选）：时区（例如，“美洲/纽约”、“欧洲/伦敦”）
  • format （可选）：输出格式（“YYYY-MM-DD HH:MM:ss”、“ISO”、“human”）

2.解析时间表达式

解析自然语言时间表达式。

参数：

  • expression （必填）：自然语言时间表达式
  • timezone （可选）：口译时区
  • referenceTime （可选）：解析参考时间

示例：

  • “下周二”
  • “30天后”
  • “明天下午3点”
  • “上周五”
  • “2小时后”
  • “下周”

3.计算时间差

计算两次之间的差值。

参数：

  • startTime （必填）：开始时间（ISO字符串或自然语言）
  • endTime （必填）：结束时间（ISO字符串或自然语言）
  • timezone （可选）：口译时区
  • unit （可选）：差异单位（“秒”、“分钟”、“小时”、“天”、“周”、“月”、“年”、“人”）

4.convert_timezone

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

参数：

  • time （必填）：转换时间（ISO字符串或自然语言）
  • fromTimezone （必填）：源时区
  • toTimezone （必填）：目标时区
  • format （可选）：输出格式

5.获取时区信息

获取特定时区的信息。

参数：

  • timezone （可选）：获取有关信息的时区

配置

可以使用环境变量配置服务器：

  • PORT：HTTP服务器端口（默认值：3335）
  • HOST：HTTP服务器主机（默认值：0.0.0.0）
  • DEFAULT_TIMEZONE：默认时区（默认：美国/纽约）
  • LIBRECHAT_USER_ID：用于分段的用户ID
  • USE_TEST_MODE：启用测试模式（默认值：false）

用法

作为HTTP服务器

PORT=3335 node index.js

作为Stdio服务器

node index.js

使用Docker

docker build -t time-mcp .
docker run -p 3335:3335 time-mcp

依赖项

  • @modelcontextprotocol/sdk：MCP协议实施
  • chrono-node：自然语言日期解析
  • moment：日期操作
  • moment-timezone：时区支持
  • express：HTTP服务器
  • cors：跨来源资源共享

示例

获取当前时间

{
  "method": "tools/call",
  "params": {
    "name": "get_current_time",
    "arguments": {
      "timezone": "America/New_York",
      "format": "human"
    }
  }
}

解析自然语言

{
  "method": "tools/call",
  "params": {
    "name": "parse_time_expression",
    "arguments": {
      "expression": "next tuesday at 3pm",
      "timezone": "America/New_York"
    }
  }
}

计算时差

{
  "method": "tools/call",
  "params": {
    "name": "calculate_time_difference",
    "arguments": {
      "startTime": "2024-01-01T00:00:00Z",
      "endTime": "2024-01-02T12:00:00Z",
      "unit": "human"
    }
  }
}

许可证

麻省理工学院

相关 MCP