DateTime MCP 服务器

一个 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

集成测试

集成测试验证服务器是否正确实现了 MCP 协议：

uv run pytest tests/acceptance/test_server_integration.py

依赖管理

# 添加生产依赖项
uv add package_name

# 添加开发依赖项
uv add --dev package_name

# 从 lockfile 同步依赖项
uv sync --frozen

# 列出过时的软件包
uv outdated

示例

将服务器与 MCP CLI 一起使用

列出可用资源：

uv run mcp resources list

读取日期时间资源：

uv run mcp resources read datetime://current

添加笔记：

uv run mcp tools call add-note --arguments '{"name": "meeting", "content": "Team meeting at 3pm"}'

获取 ISO 格式的当前时间：

uv run mcp tools call get-current-time --arguments '{"format": "iso"}'

格式化日期：

uv run mcp tools call format-date --arguments '{"date": "2023-10-15", "format": "%B %d, %Y"}'

Makefile 任务

该项目包括几个 Makefile 任务来简化开发：

# 使用冻结的 lockfile 同步所有依赖项
make uv-sync-all

# 仅同步开发依赖项
make uv-sync-dev

# 运行测试
make test

构建和发布

要准备用于分发的软件包：

1. 同步依赖项并更新 lockfile：

uv sync

2. 构建软件包分发：

uv build

这将在 dist/ 目录中创建源和 wheel 分发。

3. 发布到 PyPI：

uv publish

注意：您需要通过环境变量或命令标志设置 PyPI 凭据：

• Token: --token 或 UV_PUBLISH_TOKEN
• 或用户名/密码: --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于 MCP 服务器通过 stdio 运行，因此调试可能具有挑战性。 为了获得最佳的调试体验，我们强烈建议使用 MCP Inspector。

您可以通过 npm 使用以下命令启动 MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory /Users/malcolm/dev/bossjones/datetime-mcp-server run datetime-mcp-server

启动后，Inspector 将显示一个 URL，您可以在浏览器中访问该 URL 以开始调试。

许可证

MIT

贡献

1. Fork 存储库
2. 创建一个功能分支
3. 进行更改
4. 使用 uv run pytest 运行测试
5. 提交 pull request