MCP Datetime

🚀 mcp-datetime

mcp-datetime is an MCP server designed for date and time formatting. It supports various date and time formats and can be integrated with the Claude Desktop application through configuration.

🚀 Quick Start

Prerequisites

• Python Version: Python 3.12 or higher is required.
• Tool Dependencies:
  • uv: A library for handling asynchronous programming.
  • uvx: A tool for running MCP servers.

Installation

Method 1: Using PyPI Package

pip install mcp-datetime

Method 2: Using GitHub Source Code

git clone https://github.com/ZeparHyfar/mcp-datetime.git
cd mcp-datetime
uvx install

Method 3: Manual Installation

After downloading the source code, execute the following command:

uvx run mcp-datetime --install

Configuration in Claude Desktop

To use mcp-datetime in the Claude Desktop application, add the following content to the configuration file:

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

✨ Features

• Support for multiple date and time formatting outputs.
• Japanese language support.
• Seamless integration with the Claude Desktop application.
• High-performance, suitable for handling a large number of requests.

📦 MCP Server Components

Tool Description

• Command: get_datetime
• Parameters:
  • format: Specify the output format (optional, default is ISO format).
• Return Value: A date and time string based on the specified format.

💻 Usage Examples

Invoking the Service

uvx invoke mcp-datetime get_datetime --format iso
# Example output:
2024-12-10T00:54:01+0900

Using in Claude Desktop

const datetime = await invoke('mcp-datetime', 'get_datetime', {
  format: 'filename_log'
});
// Example output:
2024-12-10_005401.log

📚 Supported Formats

🔧 Debugging Guide

Since the MCP server runs through standard input and output, debugging can be challenging. We recommend using the MCP Inspector tool:

npx @modelcontextprotocol/inspector uvx mcp-datetime

📄 License

This project is licensed under the MIT License. For detailed terms, please refer to the LICENSE file.