mcp-datetime

mcp-日期时间

English |日语

一个日期时间格式化服务，作为 Claude 桌面应用程序的 MCP 服务器实现。支持生成各种格式的日期时间字符串。

注意：此软件包仅在 macOS 上测试过。Windows 兼容性尚未验证。

先决条件

在使用 mcp-datetime 之前，请确保已安装以下工具：

• Python 3.12 或更高版本
• uv（Python 包安装程序）
• uvx（Python 包运行器）

特征

• ✨ 支持各种日期时间格式
• 🇯🇵 日语支持
• 📁 优化文件名生成格式
• 🌏 准确的时区处理
• 🔧 与 Claude 桌面应用程序无缝集成

MCP 服务器组件

工具

服务器实现了一个工具：

• get_datetime ：以各种格式获取当前日期和时间
  • 将“格式”作为必需的字符串参数
  • 根据指定格式返回格式化的日期时间字符串
  • 支持多种格式类型，包括标准、日语和 ISO 格式

与 Claude 桌面应用程序一起使用

将以下内容添加到您的配置文件中：

配置文件位置（macOS）： ~/Library/Application Support/Claude/claude_desktop_config.json

关于安装

如果您需要直接安装软件包（例如，用于开发或源代码检查），您可以使用以下方法之一：

• 从 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”

基本示例

• 命令格式
  # Standard datetime format call datetime-service.get_datetime {"format": "datetime"} # Result: 2024-12-10 00:54:01 # Japanese format call datetime-service.get_datetime {"format": "datetime_jp"} # Result: 2024年12月10日 00時54分01秒 # Filename format call datetime-service.get_datetime {"format": "filename_md"} # Result: 20241210005401.md
• Claude 桌面应用程序提示示例
  • 用户
    Please tell me the current time in date_slash format
  • 克劳德
    I'll get the current date in date_slash format. The current date is 2024/12/12

支持的格式

调试

由于 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文件。