MCP DateTime

MCP DateTime 是一个 TypeScript 实现的 Model Context Protocol (MCP) 服务器，它为智能体系统和聊天 REPL 提供日期时间和时区信息。

概述

MCP DateTime 是一个简单的服务器，它实现了 Model Context Protocol 以向 AI 智能体和聊天界面提供日期时间和时区信息。它允许 AI 系统：

• 获取本地系统时区的当前时间
• 获取任何有效时区的当前时间
• 列出所有可用的时区
• 通过 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. 标准 I/O 模式 (默认)

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

mcp-datetime

2. Server-Sent Events (SSE) 模式

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

mcp-datetime --sse

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

mcp-datetime --sse --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

返回所有可用时区的列表。

资源 URIs

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        # 标准 I/O 模式
npm run dev:sse    # SSE 模式

许可证

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