mcp-datetime

English | 日本語

一个日期时间格式化服务，作为 Claude Desktop Application 的 MCP 服务器实现。 支持生成各种格式的日期时间字符串。

注意: 此软件包仅在 macOS 上进行了测试。 尚未验证 Windows 兼容性。

前提条件

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

• Python 3.12 或更高版本
• uv (Python 包安装器)
• uvx (Python 包运行器)

特性

• ✨ 支持各种日期时间格式
• 🇯🇵 日语支持
• 📁 针对文件名生成的优化格式
• 🌏 精确的时区处理
• 🔧 与 Claude Desktop App 无缝集成

MCP 服务器组件

工具

该服务器实现了一个工具：

• get_datetime: 获取各种格式的当前日期和时间
  • 接受 "format" 作为必需的字符串参数
  • 返回基于指定格式的格式化日期时间字符串
  • 支持多种格式类型，包括标准格式、日语格式和 ISO 格式

与 Claude Desktop App 一起使用

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

配置文件位置 (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"

基本示例

• 命令格式

  # 标准日期时间格式
  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 Desktop App 提示示例

  • 用户

    Please tell me the current time in date_slash format
    

  • Claude

    I'll get the current date in date_slash format.
    
    The current date is 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_jp	2024年12月10日 00時54分01秒	日语日期时间
datetime_t	2024-12-10T00:54:01	带有 T 分隔符的日期时间
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 文件。