Datetime

🚀 MCP 日期時間

MCP 日期時間是一個用 TypeScript 實現的 Model Context Protocol (MCP) 服務器，能為代理系統和聊天 REPL 提供日期時間和時區信息，助力 AI 系統精準獲取相關數據。

🚀 快速開始

MCP DateTime 是一個簡單的服務器，實現 Model Context Protocol，可為 AI 代理和聊天界面提供日期時間和時區信息。它允許 AI 系統獲取本地系統時鐘的當前時間、指定時區的當前時間、列出所有可用時區，還能通過 URI 資源訪問時區信息。

✨ 主要特性

• 支持多種方式獲取日期時間和時區信息，包括命令行、環境變量、工具調用和資源 URI 訪問。
• 提供標準輸入輸出模式和服務器發送事件 (SSE) 模式，滿足不同使用場景。
• 可指定自定義端口和 URI 前綴，靈活配置服務。
• 提供多個實用工具，方便獲取本地時間、時區信息等。

📦 安裝指南

從 npm

npm install -g mcp-datetime

從源代碼

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

💻 使用示例

命令行

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 前綴（默認：無）

📚 詳細文檔

可用工具

get-current-time

返回本地系統時鐘的當前時間。

get-current-timezone

返回當前系統的時區。

get-time-in-timezone

返回指定時區的當前時間。 參數：

• timezone：要獲取當前時間的時區（例如，"America/New_York"）

list-timezones

返回所有可用時區的列表。

資源 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 文件。