Chrono MCP

时间-MCP（或：时间控制模块/处理器，具体含义取决于上下文）

一个全面的模型上下文协议（MCP）服务器，提供由Luxon支持的高级日期、时间、时区和日历操作。非常适合需要强大时间数据处理能力的AI代理和应用程序。

快速入门

npx @jmoak/chrono-mcp

作为本地HTTP服务器运行

npm install
npm run build
npm run start:http
# Server listens on http://localhost:8000/mcp (health check at /health)

MCP客户端配置

配置您的MCP客户端以启动 chrono-mcp 通过 npx以下是针对特定客户的示例。

克劳德·科德

问问克劳德！这是配置：

{
  "mcpServers": {
    "chrono-mcp": {
      "command": "npx",
      "args": ["-y", "@jmoak/chrono-mcp@latest"]
    }
  }
}

光标

参考文献： Cursor MCP 文档

{
  "mcpServers": {
    "chrono-mcp": {
      "command": "npx",
      "args": ["-y", "@jmoak/chrono-mcp@latest"]
    },
    "chrono-mcp-http": {
      "type": "http",
      "url": "http://localhost:8000/mcp"
    }
  }
}

特点/特性

• 全球时区支持 - 支持所有IANA时区标识符
• 时间计算 - 添加/减去时间持续时间，计算日期之间的差异
• 多种格式 - ISO、RFC2822、SQL、支持区域设置（locale-aware）以及自定义格式化
• 类型安全 - 使用Zod进行验证，并包含全面的错误处理
• 实时 - 以微秒精度获取当前时间
• 轻松集成 - 标准MCP协议，实现无缝AI代理集成
• 优化后的令牌输出 - 动态塑造的响应，旨在最大化信息密度同时最小化令牌使用量，以实现高效的AI交互

可用工具

获取时间

获取当前时间或跨时区转换时间，并支持灵活格式化。

参数：

• datetime (字符串，可选)：ISO 日期时间字符串。默认为当前时间
• timezones (数组，可选)：用于转换的时区名称列表
• formats (数组，可选)：输出格式 (iso， rfc2822， sql， local， localeString， short， medium， long， full)
• locale (字符串，可选)：用于格式化的区域设置（例如。， en-US， fr-FR， ja-JP)
• includeOffsets (布尔值，可选)：在输出中包含UTC偏移量

示例：

输入

{
  "datetime": "2024-01-01T12:00:00Z",
  "timezones": ["America/New_York", "Asia/Tokyo"],
  "includeOffsets": true
}

输出

{
  "baseTime": "2024-01-01T12:00:00.000Z",
  "America/New_York": "2024-01-01T07:00:00.000-05:00",
  "Asia/Tokyo": "2024-01-01T21:00:00.000+09:00"
}

时间计算器

执行时间算术运算，包括持续时间计算和日期运算。

运营：

• add - 为日期时间添加持续时间
• subtract - 从日期时间中减去持续时间
• diff - 计算不同单位之间的简单差异
• duration_between - 两个时间点之间的详细时长细分
• stats - 时间序列和持续时间的统计分析
• sort - 按时间顺序排序时间戳

参数：

• operation （必填）：计算类型
• interaction_mode （可选）： auto_detect | single_to_many | many_to_single | pairwise | cross_product | aggregate默认为 auto_detect。
• base_time （可选）：基本ISO日期时间。字符串或数组。默认为当前时间。
• compare_time （可选）：比较ISO日期时间 diff/duration_between字符串或数组。
• timezone （可选）：时区为 base_time
• compare_time_timezone （可选）：时区为 compare_time
• years， months， days， hours， minutes， seconds （可选）：持续时间值

示例：

输入

{
  "operation": "add",
  "base_time": "2024-12-25T10:00:00Z",
  "days": 5,
  "hours": 3
}

输出

{
  "operation": "add",
  "interaction_mode": "single_to_single",
  "input": {
    "base_time": "2024-12-25T10:00:00.000Z",
    "duration": { "days": 5, "hours": 3 }
  },
  "result": "2024-12-30T13:00:00.000Z",
  "result_timezone": "UTC"
}

Development

先决条件

• Node.js 版本 >= 22.0.0
• npm 或 yarn

设置

git clone https://github.com/yourusername/chrono-mcp.git
cd chrono-mcp
npm install

构建

npm run build

测试与检验员

npm test
npm run test:ui
npm run inspector

参观 http://localhost:6274 用于网页检查器用户界面。

Linting（代码检查）

npm run lint
npm run lint:fix

支持的时区

支持所有IANA时区标识符，包括：

• 美洲: America/New_York， America/Los_Angeles， America/Toronto等。
• 欧洲： Europe/London， Europe/Paris， Europe/Berlin等。
• 亚洲： Asia/Tokyo， Asia/Shanghai， Asia/Dubai等。
• 澳大利亚： Australia/Sydney， Australia/Melbourne等。
• 以及400多个更多（选项/项目/等）。。。

致谢

这个项目由……提供支持/驱动 Luxon（卢克松），这是一个优秀的 DateTime 库，提供了强大的时区处理和日期运算功能。我们非常感谢 Luxon 团队为时间操作奠定了如此可靠的基础。

许可证

MIT 许可证 - 详见 许可证 文件中有详细信息。

发布

看 以了解详细变更。