🚀 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- 帮助用户安排特定时间的事件。
📦 安装指南
- 克隆仓库：
git clone https://github.com/bossjones/datetime-mcp-server.git
cd datetime-mcp-server
- 创建虚拟环境：
uv venv
source .venv/bin/activate
- 安装依赖项：
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 许可证。
贡献
如果你想为项目做出贡献，可以按照以下步骤进行：
- 叉仓库
- 创建功能分支
- 进行修改
- 使用
uv run pytest运行测试 - 提交拉取请求