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-帮助在特定时间安排活动
安装
- 克隆存储库：
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发展
安装开发依赖项
# 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任务，以简化开发：
# Sync all dependencies with frozen lockfile
make uv-sync-all
# Sync only development dependencies
make uv-sync-dev
# Run tests
make test建筑与出版
准备分发包裹：
- 同步依赖关系并更新锁文件：
uv sync- 构建包分发：
uv build这将在 dist/ 目录。
- 发布到PyPI：
uv publish注意：您需要通过环境变量或命令标志设置PyPI凭据：
- 令牌：
--token或UV_PUBLISH_TOKEN - 或用户名/密码：
--username/UV_PUBLISH_USERNAME和--password/UV_PUBLISH_PASSWORD
调试
由于MCP服务器在stdio上运行，调试可能具有挑战性。为了达到最佳调试效果 经验，我们强烈建议使用 MCP检查员.
您可以通过以下方式启动MCP检查器 使用此命令：
npx @modelcontextprotocol/inspector uv --directory /Users/malcolm/dev/bossjones/datetime-mcp-server run datetime-mcp-server启动后，检查器将显示一个URL，您可以在浏览器中访问该URL以开始调试。
许可证
麻省理工学院
贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 使用以下命令运行测试
uv run pytest - 提交拉取请求