mcp-datetime

英語 |日本語

Claudeデスクトップアプリケーション用のMCPサーバーとして実装された日時フォーマットサービス。様々な形式の日時文字列の生成をサポートします。

注意：このパッケージはmacOSでのみテストされています。Windowsとの互換性は検証されていません。

前提条件

mcp-datetime を使用する前に、次のツールがインストールされていることを確認してください。

• Python 3.12以降

• uv (Python パッケージインストーラー)

• uvx (Python パッケージ ランナー)

Related MCP server: Time MCP

特徴

• ✨ さまざまな日付時刻形式をサポート

• 🇯🇵日本語サポート

• 📁 ファイル名生成のための最適化された形式

• 🌏 正確なタイムゾーン処理

• 🔧 Claudeデスクトップアプリとのシームレスな統合

MCP サーバー コンポーネント

ツール

サーバーは 1 つのツールを実装します。

• get_datetime : 現在の日付と時刻をさまざまな形式で取得する

  • 必須の文字列引数として「format」を取ります

  • 指定された形式に基づいてフォーマットされた日付時刻文字列を返します。

  • 標準、日本語、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

サポートされている形式

デバッグ

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ファイルを参照してください。