JinDaGe - DateTime MCP Details

article

README

🚀 MCP 日期时间

MCP 日期时间是一个用 TypeScript 实现的 Model Context Protocol (MCP) 服务器，它能为代理系统和聊天 REPL 提供日期时间和时区信息，助力 AI 系统精准获取相关数据。

🚀 快速开始

MCP DateTime 是一个简单的服务器，实现 Model Context Protocol，以为 AI 代理和聊天界面提供日期时间和时区信息。它允许 AI 系统获取本地系统时钟的当前时间、指定时区的当前时间，列出所有可用时区，还能通过 URI 资源访问时区信息。

✨ 主要特性

可获取本地系统时钟的当前时间。
能获取指定时区的当前时间。
支持列出所有可用时区。
可通过 URI 资源访问时区信息。

📦 安装指南

从 npm

npm install -g mcp-datetime

从源代码

git clone https://github.com/odgrmi/mcp-datetime.git
cd mcp-datetime
npm install
npm run build

💻 使用示例

命令行

MCP DateTime 可以在两种模式下运行：

1. 标准输入输出模式（默认）

此模式适用于支持通过标准输入/输出的 MCP 协议集成的 AI 系统：

mcp-datetime

2. 服务器发送事件 (SSE) 模式

此模式启动一个 HTTP 服务器，提供 SSE 运输的 MCP 协议：

mcp-datetime --sae

您还可以指定自定义端口和 URI 前缀：

mcp-datetime --sae --port=8080 --prefix=/api/datetime

环境变量

PORT：设置 SSE 模式的端口（默认：3000）
URI_PREFIX：设置 SSE 模式的 URI 前缀（默认：无）

📚 详细文档

可用工具

MCP DateTime 提供以下工具：

get-current-time：返回本地系统时钟的当前时间。
get-current-timezone：返回当前系统的时区。
get-time-in-timezone：返回指定时区的当前时间。
- 参数：
  - timezone：要获取当前时间的时区（例如，"America/New_York"）
list-timezones：返回所有可用时区的列表。

资源 URI

MCP DateTime 还通过资源 URI 提供时区信息：

datetime://{timezone}：返回指定时区的当前时间。
- 示例：datetime://America/New_York
datetime://list：返回所有可用时区的列表。

常见时区

以下常见时区始终可用：

UTC
Europe/London
Europe/Paris
Europe/Berlin
America/New_York
America/Chicago
America/Denver
America/Los_Angeles
Asia/Tokyo
Asia/Shanghai
Asia/Kolkata
Australia/Sydney
Pacific/Auckland

SSE 终端点

在 SSE 模式下，以下终端点可用：

/sse：SSE 连接终端点
/message：客户端到服务器通信的消息终端点
/info：基本服务器信息

如果指定了 URI 前缀，则会将其附加到所有终端点。

与 AI 系统的集成

MCP DateTime 可以与支持 Model Context Protocol 的 AI 系统集成。这使 AI 代理能够访问准确的时区和日期时间信息。

🔧 技术细节

开发

先决条件

Node.js 14.16 或更高版本
npm

设置

git clone https://github.com/odgrim/mcp-datetime.git
cd mcp-datetime
npm install

构建

npm run build

开发模式运行

npm run dev        # 标准输入输出模式
npm run dev:sae    # SSE 模式

📄 许可证

本项目根据 Mozilla Public License 2.0 许可，有关详细信息请参阅 LICENSE 文件。

DateTime