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
- 无需全系统安装
- 通过标准配置轻松部署
许可证
麻省理工学院
