mcp-datetime

MIT License
7
  • Apple

local-only server

The server can only run on the client’s local machine because it depends on local resources.

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

{ "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”

基本示例

  • 命令格式
    # 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

支持的格式

格式名称例子描述
日期2024年12月10日标准日期格式
日期斜线2024年12月10日带斜线的日期
date_jp2024年12月10日日语日期格式
日期时间2024年12月10日 00:54:01标准日期时间
datetime_jp2024年12月10日 00时54分01秒日语日期时间
datetime_t2024年12月10日00:54:01带有 T 分隔符的日期时间
袖珍的20241210005401紧凑的身份证格式
compact_date2024年12月10日仅限紧凑日期
紧凑时间005401仅限紧凑时间
文件名_md20241210005401.mdMarkdown 文件名
文件名_txt20241210005401.txt文本文件名
文件名_日志20241210005401.日志日志文件名
异质2024年12月10日00:54:01+0900ISO 8601 格式
iso_basic20241210T005401+0900基本 ISO 格式
日志2024年12月10日 00:54:01.123456以微秒为单位的日志格式
log_compact20241210_005401紧凑日志格式
时间00:54:01仅限时间
time_jp00时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文件。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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

  1. Prerequisites
    1. Features
      1. MCP Server Components
        1. Tools
      2. Usage with Claude Desktop App
        1. About Installation
          1. Basic Examples
            1. Supported Formats
              1. Debugging
                1. License
                  ID: y4oh57n2vq