使用说明

项目简介

mcp-datetime 是一个实现了 Model Context Protocol (MCP) 协议的服务器，专门为 LLM 客户端（如 Claude Desktop App）提供日期和时间格式化服务。通过该服务，LLM 可以轻松获取各种预定义格式的当前日期和时间字符串，用于生成内容或执行相关操作。

主要功能点

多种日期时间格式支持: 支持丰富的日期和时间格式，包括标准格式、ISO 格式、紧凑格式（用于文件名等）、以及日语格式等，满足不同场景下的时间格式需求。
文件名友好格式: 特别优化了生成文件名的格式，方便 LLM 创建和管理文件。
精确时区处理: 能够准确处理时区信息，确保返回的日期和时间是当前所在时区的正确时间。
Claude Desktop App 集成: 可以无缝集成到 Claude Desktop App 中，作为其扩展功能使用。

安装步骤

您可以通过以下任一方式安装 mcp-datetime 服务：

方法一：使用 pip 从 PyPI 安装 (推荐)

pip install mcp-datetime

方法二：从 GitHub 源码安装

git clone https://github.com/MCP-Mirror/ZeparHyfar_mcp-datetime.git
cd mcp-datetime
pip install -e .

服务器配置

要将 mcp-datetime 服务配置到 MCP 客户端（例如 Claude Desktop App），您需要在客户端的配置文件中添加 MCP 服务器的描述信息。

对于 Claude Desktop App，配置文件通常位于 macOS 的 '~/Library/Application Support/Claude/claude_desktop_config.json'。请将以下 JSON 配置添加到 'mcpServers' 字段中：

{
  "mcpServers": {
    "mcp-datetime": {
      "command": "uvx",
      "args": ["mcp-datetime"]
    }
  }
}

配置参数说明:

'"mcp-datetime"': 服务器名称，客户端通过此名称引用该服务。
'"command": "uvx"': 启动服务器的命令，这里使用 'uvx' (Python 包运行器) 来运行 'mcp-datetime' 包。
'"args": ["mcp-datetime"]': 传递给 'uvx' 命令的参数，指定要运行的 Python 包为 'mcp-datetime'。

如果您选择手动安装或需要指定 Python 路径，可以使用以下配置 (需要替换 '/path/to/your/python' 为您实际的 Python 解释器路径):

{
  "mcpServers": {
    "mcp-datetime": {
      "command": "python",
      "args": ["-m", "mcp_datetime"],
      "env": {
        "PYTHON": "/path/to/your/python"
      }
    }
  }
}

基本使用方法

配置完成后，在 MCP 客户端中，您可以使用 'call' 命令调用 'datetime-service.get_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秒

# 获取 Markdown 文件名格式
call datetime-service.get_datetime {"format": "filename_md"}
# 返回结果示例: 20241210005401.md

支持的格式类型 (format 参数可选值):

'date': 标准日期格式 (YYYY-MM-DD)
'date_slash': 日期格式，斜线分隔 (YYYY/MM/DD)
'date_jp': 日语日期格式 (YYYY年MM月DD日)
'datetime': 标准日期时间格式 (YYYY-MM-DD HH:MM:SS)
'datetime_jp': 日语日期时间格式 (YYYY年MM月DD日 HH時MM分SS秒)
'datetime_t': 日期时间格式，T 分隔符 (YYYY-MM-THH:MM:SS)
'compact': 紧凑格式，无分隔符 (YYYYMMDDHHMMSS)
'compact_date': 紧凑日期格式 (YYYYMMDD)
'compact_time': 紧凑时间格式 (HHMMSS)
'filename_md': Markdown 文件名格式 (YYYYMMDDHHMMSS.md)
'filename_txt': 文本文件名格式 (YYYYMMDDHHMMSS.txt)
'filename_log': 日志文件名格式 (YYYYMMDDHHMMSS.log)
'iso': ISO 8601 格式 (YYYY-MM-DDTHH:MM:SS+ZZZZ)
'iso_basic': 基本 ISO 格式 (YYYYMMDDTHHMMSS+ZZZZ)
'log': 日志格式，带微秒 (YYYY-MM-DD HH:MM:SS.ffffff)
'log_compact': 紧凑日志格式 (YYYYMMDD_HHMMSS)
'time': 时间格式 (HH:MM:SS)
'time_jp': 日语时间格式 (HH時MM分SS秒)

更多详细信息请参考项目仓库 README 文档。

关键词