mcp-datetime
英文 | 日语
一个为Claude桌面应用程序实现的datetime格式化服务MCP服务器。支持生成多种格式的datetime字符串。
注意：该软件包仅在macOS上经过测试。Windows兼容性尚未验证。
前置条件
在使用mcp-datetime之前，请确保已安装以下工具：
- Python 3.12或更高版本
- uv（Python软件包安装器）
- uvx（Python软件包运行器）
功能
- ✨ 支持多种datetime格式
- 🇯🇵 日语支持
- 📁 优化的文件名生成格式
- 🌏 精确的时区处理
- 🔧 与Claude桌面应用程序的无缝集成
MCP服务器组件
工具
服务器实现了一个工具：
get_datetime：获取多种格式的当前日期和时间- 接收"format"作为必需的字符串参数
- 返回基于指定格式的格式化datetime字符串
- 支持多种格式类型，包括标准、日语和ISO格式
与Claude桌面应用程序的配合使用
将以下内容添加到您的配置文件中：
配置文件位置（macOS）：
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"mcp-datetime": {
"command": "uvx",
"args": ["mcp-datetime"]
}
}
}
关于安装
如果您需要直接安装软件包（例如，用于开发或源代码检查），可以使用以下方法之一：
-
从PyPI安装
pip install mcp-datetime -
从GitHub源代码安装
git clone https://github.com/ZeparHyfar/mcp-datetime.git cd mcp-datetime pip install -e . -
手动安装的示例
claude_desktop_config.json{ "mcpServers": { "mcp-datetime": { "command": "python", "args": ["-m", "mcp_datetime"], "env": { "PYTHON": "/path/to/your/python" } } } }将"/path/to/your/python"替换为您的实际Python解释器路径
例如，"/usr/local/bin/python3"或"/Users/username/.pyenv/versions/3.12.0/bin/python3"
基本示例
-
命令格式
# 标准datetime格式 call datetime-service.get_datetime {"format": "datetime"} # 结果：2024-12-10 00:54:01 # 日语格式 call datetime-service.get_datetime {"format": "datetime_jp"} # 结果：2024年12月10日 00時54分01秒 # 文件名格式 call datetime-service.get_datetime {"format": "filename_md"} # 结果：20241210005401.md -
Claude桌面应用程序提示示例
-
用户
请告诉我以date_slash格式的当前时间 -
Claude
我将获取以date_slash格式的当前日期。 当前日期是 2024/12/12
-
支持的格式
| 格式名称 | 示例 | 描述 |
|---|---|---|
| date | 2024-12-10 | 标准日期格式 |
| date_slash | 2024/12/10 | 带斜杠的日期 |
| date_jp | 2024年12月10日 | 日语日期格式 |
| datetime | 2024-12-10 00:54:01 | 标准datetime |
| datetime_jp | 2024年12月10日 00時54分01秒 | 日语datetime |
| datetime_t | 2024-12-10T00:54:01 | 带T分隔符的datetime |
| compact | 20241210005401 | 用于ID的紧凑格式 |
| compact_date | 20241210 | 仅日期的紧凑格式 |
| compact_time | 005401 | 仅时间的紧凑格式 |
| filename_md | 20241210005401.md | Markdown文件名 |
| filename_txt | 20241210005401.txt | 文本文件名 |
| filename_log | 20241210005401.log | 日志文件名 |
| iso | 2024-12-10T00:54:01+0900 | ISO 8601格式 |
| iso_basic | 20241210T005401+0900 | 基本ISO格式 |
| log | 2024-12-10 00:54:01.123456 | 带微秒的日志格式 |
| log_compact | 20241210_005401 | 紧凑日志格式 |
| time | 00:54:01 | 仅时间 |
| time_jp | 00時54分01秒 | 日语时间格式 |
调试
由于MCP服务器通过stdio运行，调试可能具有挑战性。我们建议使用MCP Inspector：
-
使用PyPI软件包
npx @modelcontextprotocol/inspector uvx mcp-datetime -
使用从GitHub下载的源代码
git clone https://github.com/ZeparHyfar/mcp-datetime.git npx @modelcontextprotocol/inspector uvx --directory ./mcp-datetime run mcp-datetime
许可证
本项目根据MIT许可证授权 - 详细内容请参阅LICENSE文件。