mcp-datetime

Name: mcp-datetime
Author: ZeparHyfar

@ZeparHyfar

リポジトリ

mcp-datetime について

A MCP server for datetime formatting and file name generation.

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

ZeparHyfar

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

Get current date and time in various formats

概要

What is mcp-datetime?

mcp-datetime is a datetime formatting service implemented as an MCP server for the Claude Desktop Application. It generates datetime strings in various formats and has been tested only on macOS.

How to use mcp-datetime?

Add the server configuration to ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, using uvx as the command with "mcp-datetime" as the argument. Once configured, use the get_datetime tool with a "format" argument (e.g., "datetime", "datetime_jp", "filename_md") to retrieve the current date and time in the desired format.

Key features of mcp-datetime

Support for various datetime formats (standard, Japanese, ISO, compact, filename, log)
Japanese language support for dates and times
Optimized formats for file name generation (Markdown, text, log)
Accurate timezone handling
Seamless integration with the Claude Desktop App

Use cases of mcp-datetime

Get current date and time in standard, slash-separated, or ISO 8601 formats
Generate compact datetime strings for unique identifiers or log entries
Create filename-friendly datetime strings for Markdown, text, or log files
Use natural language prompts in Claude Desktop to retrieve formatted datetime (e.g., "Tell me the current time in date_slash format")

FAQ from mcp-datetime

What runtime and tools does mcp-datetime require?

Python 3.12 or later and uv (Python package installer) with uvx (Python package runner) are required.

How do I install mcp-datetime?

Install from PyPI with pip install mcp-datetime, or clone the GitHub repository and run pip install -e . for development or source code inspection.

What formats are supported?

The server supports 18 formats including date (2024-12-10), datetime (2024-12-10 00:54:01), date_jp (2024年12月10日), datetime_jp (2024年12月10日 00時54分01秒), compact (20241210005401), filename_md (20241210005401.md), iso (2024-12-10T00:54:01+0900), and log (2024-12-10 00:54:01.123456). See the README for the full list.

Is mcp-datetime tested on Windows?

No. The package has been tested only on macOS; Windows compatibility has not been verified.

How can I debug mcp-datetime?

Use the MCP Inspector by running npx @modelcontextprotocol/inspector uvx mcp-datetime for the PyPI package, or npx @modelcontextprotocol/inspector uvx --directory ./mcp-datetime run mcp-datetime for a local clone.