Datetime MCP Server

🚀 DateTime MCP 服務器

DateTime MCP 服務器是一個基於 MCP（模型完成協議）的服務器，它提供了豐富的日期時間工具和簡單筆記管理功能，能有效滿足用戶對日期時間信息獲取和筆記管理的需求。

🚀 快速開始

DateTime MCP 服務器實現了 MCP 協議，為用戶提供了一系列與日期時間相關的工具和服務，還具備簡單筆記管理功能，任何 MCP 客戶端都能使用該服務器來訪問日期和時間信息，以及管理簡單筆記。

✨ 主要特性

資源

服務器提供了以下實用資源：

• datetime://current - 可獲取當前的日期和時間。
• datetime://today - 以 ISO 格式呈現今天的日期。
• datetime://time - 顯示當前時間，採用 24 小時制格式。
• note://internal/{name} - 用於存儲用戶創建的筆記。

工具

服務器提供了多種實用工具：

• add-note - 方便用戶添加具有名稱和內容的新筆記。
• get-current-time - 支持獲取當前時間的各種格式，如 ISO、可讀、Unix 時間戳、RFC3339 等。
• format-date - 可根據指定的格式模式對日期字符串進行格式化。

提示

服務器還提供了以下提示功能：

• summarize-notes - 能夠創建所有筆記的摘要。
• schedule-event - 幫助用戶安排特定時間的事件。

📦 安裝指南

1. 克隆倉庫：

git clone https://github.com/bossjones/datetime-mcp-server.git
cd datetime-mcp-server

2. 創建虛擬環境：

uv venv
source .venv/bin/activate

3. 安裝依賴項：

uv sync

💻 使用示例

基礎用法

運行服務器

uv run python -m datetime_mcp_server.server

服務器啟動後，會在 stdin/stdout 上監聽 MCP 協議消息。

連接到服務器

可以使用任何 MCP 客戶端連接到服務器，例如使用 MCP CLI：

uv run mcp connect datetime-mcp-server

高級用法

安裝開發依賴項

# 安裝所有依賴項包括開發依賴項
uv sync --dev

運行測試

uv run pytest tests/

單元測試

單元測試用於驗證服務器的各個功能是否正常工作：

uv run pytest tests/acceptance/test_server.py

集成測試

集成測試用於驗證服務器各部分之間的交互：

uv run pytest tests/integration/test_integration.py

使用 Makefile 任務

文檔中雖未提供 Makefile 的具體內容，但通常會包含以下任務：

• make install - 安裝依賴項
• make test - 運行測試
• make lint - 格式化和檢查代碼風格
• make build - 構建發佈包

📄 許可證

本項目採用 MIT 許可證。

貢獻

如果你想為項目做出貢獻，可以按照以下步驟進行：

1. 叉倉庫
2. 創建功能分支
3. 進行修改
4. 使用 uv run pytest 運行測試
5. 提交拉取請求