使用说明
日期时间mcp服务器
一个简单、专注的MCP(模型上下文协议)服务器,提供当前日期和时间信息。此服务器使Claude能够始终获得准确的当前日期/时间,而不是依赖过时的会话开始日期。
特性
-
三个日期时间工具 对于不同的用例:
get_current_datetime:返回带时区的ISO 8601格式get_current_date:以YYYY-MM-DD格式返回日期get_formatted_datetime:返回人类可读的格式
-
欧洲/阿姆斯特丹时区 -所有时间均为CET/CEST时区
-
正确的错误处理 -优雅的错误管理
-
键入提示 -完整类型注释可提高代码质量
-
清洁实施 -简单、专注、无额外功能
安装
先决条件
- Python 3.10或更高版本
- pip包管理器
从源代码安装
- 克隆存储库:
git clone https://github.com/<ACTUAL_USERNAME_OR_ORG>/datetime-mcp-server.git
cd datetime-mcp-server
- 安装软件包:
pip install -e .
或者直接安装依赖项:
pip install -r requirements.txt
用法
独立运行服务器
您可以直接运行服务器来测试它:
python -m datetime_mcp_server.server
添加到Claude桌面
要将此MCP服务器与Claude Desktop一起使用,请将以下内容添加到您的Claude Desktop配置文件中:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"datetime": {
"command": "python",
"args": [
"-m",
"datetime_mcp_server.server"
],
"env": {
"PYTHONPATH": "/absolute/path/to/datetime-mcp-server/src"
}
}
}
}
替换 /absolute/path/to/datetime-mcp-server/src 实际绝对路径为 src 安装中的目录。
或者,如果您在全局或虚拟环境中安装了该软件包:
{
"mcpServers": {
"datetime": {
"command": "python",
"args": [
"-m",
"datetime_mcp_server.server"
]
}
}
}
更新配置后,重新启动Claude Desktop。
可用工具
get_current _日期时间
返回ISO 8601格式的当前日期和时间以及时区信息。
输出示例: 2025-12-03T14:30:15.123456+01:00
get_current _日期
仅返回YYYY-MM-DD格式的当前日期。
输出示例: 2025-12-03
get_formatted_datetime
以人类可读的格式返回当前日期和时间。
输出示例: Wednesday, December 03, 2025 - 14:30:15 CET
发展
项目结构
datetime-mcp-server/
├── src/
│ └── datetime_mcp_server/
│ ├── __init__.py
│ └── server.py
├── pyproject.toml
├── requirements.txt
└── README.md
运行测试
安装开发依赖项:
pip install -e ".[dev]"
运行测试:
pytest
技术细节
- 语言:Python 3.10+
- 框架:MCP Python SDK
- 时区:欧洲/阿姆斯特丹(CET/CEST)
- 协议:模型上下文协议(MCP)
为什么选择此服务器?
Claude对当前日期/时间的了解是基于会话开始时间,在长时间对话中可能会变得过时。此MCP服务器为Claude提供了一种可靠的方式:
- 获取当前的实际日期和时间
- 日期格式一致
- 使用准确的时区信息
- 避免因过时的会话数据而产生混淆
许可证
MIT许可证-可根据需要自由使用和修改。
贡献
欢迎投稿!请随时提交拉取请求。
支持
对于问题或疑问,请在GitHub存储库上打开问题。
