mcp-datetime

mcp-datetime

English | 日本語

Claude Desktop Application 向けの MCP サーバーとして実装された日時フォーマットサービスです。さまざまな形式での日時文字列の生成をサポートします。

Note: このパッケージは macOS でのみテストされています。Windows での互換性は確認されていません。

前提条件

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

• Python 3.12 以降
• uv (Python パッケージインストーラー)
• uvx (Python パッケージランナー)

機能

• ✨ さまざまな日時フォーマットをサポート
• 🇯🇵 日本語サポート
• 📁 ファイル名生成に最適化されたフォーマット
• 🌏 正確なタイムゾーン処理
• 🔧 Claude Desktop App とのシームレスな統合

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

ツール

このサーバーは 1 つのツールを実装しています:

• get_datetime: さまざまな形式で現在の日時を取得します
  • 必須の文字列引数として「format」を受け取ります
  • 指定されたフォーマットに基づいてフォーマット済みの日時文字列を返します
  • 標準、日本語、ISO フォーマットを含む複数のフォーマットタイプをサポートします

Claude Desktop App での使用

設定ファイルに以下を追加してください:

設定ファイルの場所 (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 Desktop App のプロンプト例

  • ユーザー

    Please tell me the current time in date_slash format
    

  • Claude

    I'll get the current date in date_slash format.
    
    The current date is 2024/12/12
    

サポートされているフォーマット

Format Name	Example	Description
date	2024-12-10	標準の日付フォーマット
date_slash	2024/12/10	スラッシュ区切りの日付
date_jp	2024年12月10日	日本語の日付フォーマット
datetime	2024-12-10 00:54:01	標準の日時フォーマット
datetime_jp	2024年12月10日 00時54分01秒	日本語の日時フォーマット
datetime_t	2024-12-10T00:54:01	T 区切り記号付きの日時
compact	20241210005401	ID 用のコンパクトなフォーマット
compact_date	20241210	日付のみのコンパクトなフォーマット
compact_time	005401	時刻のみのコンパクトなフォーマット
filename_md	20241210005401.md	Markdown ファイル名
filename_txt	20241210005401.txt	テキストファイル名
filename_log	20241210005401.log	ログファイル名
iso	2024-12-10T00:54:01+0900	ISO 8601 フォーマット
iso_basic	20241210T005401+0900	基本 ISO フォーマット
log	2024-12-10 00:54:01.123456	マイクロ秒付きのログフォーマット
log_compact	20241210_005401	コンパクトなログフォーマット
time	00:54:01	時刻のみ
time_jp	00時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 ファイルを参照してください。