时间服务协议

MCP DateTime是一个基于TypeScript实现的模型上下文协议服务器,为AI代理和聊天界面提供日期、时间和时区信息。

  • by odgrim
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 odgrim/mcp-datetime

使用说明

MCP日期时间

模型上下文协议(MCP)服务器的TypeScript实现,为代理系统和聊天REPL提供日期时间和时区信息。

概述

MCP DateTime是一个简单的服务器,它实现了 模型上下文协议 为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)模式

此模式启动为MCP协议提供SSE传输的HTTP服务器:

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:获取当前时间的时区(例如,“美国/纽约”)

list-timezones

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

资源URI

MCP DateTime还通过资源URI提供对时区信息的访问:

datetime://{timezone}

返回指定时区的当前时间。

例子: datetime://America/New_York

datetime://list

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

常见时区

以下常见时区始终可用:

  • 协调世界时
  • 欧洲/伦敦
  • 欧洲/巴黎
  • 欧洲/柏林
  • 美国/纽约
  • 美国/芝加哥
  • 美国/丹佛
  • 美国/洛杉矶
  • 亚洲/东京
  • 亚洲/上海
  • 亚洲/加尔各答
  • 澳大利亚/悉尼
  • 太平洋/奥克兰

SSE 端点

在SSE模式下运行时,以下端点可用:

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

如果指定了URI前缀,它将被添加到所有端点之前。

与人工智能系统集成

MCP DateTime可以与支持模型上下文协议的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        # Standard I/O mode
npm run dev:sse    # SSE mode

许可证

此项目根据Mozilla公共许可证2.0获得许可-请参阅 许可证 文件以获取详细信息。