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. 服务端发送事件（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

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

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

许可证

本项目根据Mozilla Public License 2.0许可发布 - 详情请参阅LICENSE文件。