DateTime MCP Server

DateTime MCP Server

一个 MCP（Model Completions Protocol）服务，提供日期时间功能以及简单的笔记管理功能。

概述

此服务实现了 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

开发

安装开发依赖项

# Install all dependencies including development dependencies
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

依赖项管理

# Add a production dependency
uv add package_name

# Add a development dependency
uv add --dev package_name

# Sync dependencies from lockfile
uv sync --frozen

# List outdated packages
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 任务，可简化开发流程：

# Sync all dependencies with frozen lockfile
make uv-sync-all

# Sync only development dependencies
make uv-sync-dev

# Run tests
make test

构建和发布

准备分发软件包：

1. 同步依赖项并更新锁定文件：

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