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. 提交拉取请求