使用说明
MCP服务器日期
一个轻量级的模型上下文协议（MCP）服务器，使用Python和.NET构建，为AI助手提供当前日期和日期信息 uv 为了实现最大的便携性。
特性
- get_day_name：返回一周中的当前日期（例如“Monday”）
- get_iso_date：以ISO 8601格式返回当前日期（YYYY-MM-DD）
非常适合像GitHub Copilot这样的人工智能助手，在处理笔记、文档或时间敏感任务时需要可靠、始终准确的日期信息。
快速开始
先决条件
- Python 3.10或更高版本
- 紫外线 包管理器
安装
# Clone or navigate to the project
cd DateMCP
# Install dependencies with uv
uv sync
运行服务器
始终使用 uv 运行服务器，使Python运行时由项目环境固定。
- 运行已安装的项目脚本（首选）：
uv run -- date-mcp
如果你更喜欢在开发过程中直接运行模块，你仍然可以运行：
uv run -- python -m src.date_mcp
服务器通过stdio进行通信，并已准备好接收MCP请求。
VS代码集成
要在VS Code中使用GitHub Copilot，请参阅 VS_CODE_CONFIG.md 有关详细的设置说明。
项目结构
DateMCP/
├── pyproject.toml # Project configuration and dependencies
├── src/
│ ├── __init__.py # Package initializer
│ └── date_mcp.py # Main MCP server implementation (moved)
├── README.md # This file
└── VS_CODE_CONFIG.md # VS Code configuration guide
运作原理
服务器使用标准 MCP Python SDK 展示两个简单的工具：
- get_day_name（）：用途
datetime.now().strftime("%A")返回当前日期 - get_isodate（）：用途
datetime.now().strftime("%Y-%m-%d")返回当前日期
这些工具由MCP客户端发现，LLM可以在需要时调用。
为什么这很重要
人工智能助手经常遇到以下问题：
- 知道当前日期
- 执行基于日期的计算
- 为内容添加准确的时间戳
通过为MCP服务器提供可靠的日期工具，您的AI助手（无论是Copilot、Claude还是其他兼容MCP的客户端）始终可以访问准确的日期信息，而无需依赖训练数据或假设。
发展
添加更多工具
要添加其他日期工具，只需添加更多装饰有 @mcp.tool():
@mcp.tool()
def get_unix_timestamp() -> int:
"""Get the current Unix timestamp.
Returns:
int: Current time in seconds since epoch
"""
return int(datetime.now().timestamp())
本地测试
服务器将JSON-RPC消息输出到stdout。对于调试，您可以使用 MCP调试工具.
使用MCP检查器进行交互式测试
您可以使用官方的MCP检查器工具交互式地测试MCP服务器。
- 安装MCP检查器（如果尚未安装）：
npm install -g @modelcontextprotocol/inspector
- 运行检查器并将其指向您的服务器：
npx @modelcontextprotocol/inspector uv run -- date-mcp
这将：
- 使用固定的启动MCP服务器
uv环境 - 启动web界面（通常在http://localhost:5173)
- 允许您以交互方式测试工具
- 在Inspector web UI中，您可以：
- 请参阅两个可用工具：
get_day_name和get_iso_date - 点击每个工具以执行它
- 实时查看响应
- 检查正在交换的JSON-RPC消息
或者，您可以直接运行服务器并单独连接检查器：
# Terminal 1: Start the server
uv run -- date-mcp
# Terminal 2: Connect inspector to running server
npx @modelcontextprotocol/inspector
可移植性
内置于 uv 为了获得最大的便携性：
- 单一依赖关系：
mcp - 适用于macOS、Linux和Windows
- 无需全系统安装
- 通过标准配置轻松部署
许可证
麻省理工学院
