@koinunopochi/datetime

現在日時と曜日を返す Model Context Protocol (MCP) サーバーです。

インストール

npm install -g @koinunopochi/datetime

または、npx で直接実行:

npx @koinunopochi/datetime

機能

ツール: current-datetime

指定されたタイムゾーンとロケールで現在日時と曜日を返します。

パラメータ

• timeZone (string, optional): IANA タイムゾーン ID (例: Asia/Tokyo)
  • 省略時はシステムのデフォルトタイムゾーンを使用
• locale (string, optional): ロケール (例: ja-JP)
  • 省略時は ja-JP を使用

レスポンス

{
  "content": [
    {
      "type": "text",
      "text": "日時: 2024-01-20 15:30:45\n曜日: 土曜日\nタイムゾーン: Asia/Tokyo (+09:00)"
    }
  ],
  "metadata": {
    "locale": "ja-JP",
    "timeZone": "Asia/Tokyo",
    "weekday": "土曜日",
    "formatted": "2024-01-20 15:30:45",
    "utcTimestamp": "2024-01-20T06:30:45.123Z",
    "offset": "+09:00"
  }
}

使用例

MCP クライアントからの使用

MCP 対応クライアントで以下のように設定:

{
  "mcpServers": {
    "datetime": {
      "command": "npx",
      "args": ["@koinunopochi/datetime"]
    }
  }
}

開発

# ソースからビルド
npm run build

# 開発モード（ファイル監視）
npm run dev

# クリーンビルド
npm run clean && npm run build

技術仕様

• Node.js: 18.18 以上
• TypeScript: 5.3 以上
• MCP SDK: @modelcontextprotocol/sdk
• スキーマ検証: zod

特徴

• サロゲートペア対応の正確な文字数カウント
• 国際化対応（任意のロケールをサポート）
• タイムゾーン対応（IANA タイムゾーン ID をサポート）
• TypeScript による型安全性

エラーハンドリング

• 無効なタイムゾーン ID が指定された場合、エラーメッセージを返します
• 無効なロケールが指定された場合、エラーメッセージを返します

ライセンス

MIT