@dandeliongold/mcp-time

@dandeliongold/mcp-time

JavaScript の Date を使用して、現在時刻を ISO 形式（YYYY-MM-DD HH:mm:ss）で取得する MCP サーバーです。このサーバーは、Windows と macOS の両方で Claude デスクトップアプリと連携します。

コンポーネント

ツール

1. getCurrentTime

   • 現在時刻を ISO 形式で返します
   • 入力パラメーターは不要です
   • 戻り値：

     {
       "time": "2024-02-08 11:04:33",
       "success": true
     }
     

   JSON-RPC リクエストの例：

   {
     "jsonrpc": "2.0",
     "id": 1,
     "method": "getCurrentTime"
   }
   

   JSON-RPC レスポンスの例：

   {
     "jsonrpc": "2.0",
     "id": 1,
     "result": {
       "time": "2024-02-08 11:04:33",
       "success": true
     }
   }
   

2. getTimeDifference

   • 指定したタイムスタンプと現在時刻の時間差を計算します
   • パラメーター：
     • timestamp：ISO 形式のタイムスタンプ（YYYY-MM-DD HH:mm:ss）
     • interval：'minutes'（デフォルト）または'seconds'
   • 次の規則に従って、符号付きの差分値を返します：
     • 正の値（+）は未来のタイムスタンプを示します（「あと X 分／秒」）
     • 負の値（-）は過去のタイムスタンプを示します（「X 分／秒前」）
     • ゼロ（0）は同じタイムスタンプを示します

   JSON-RPC リクエストの例：

   {
     "jsonrpc": "2.0",
     "id": 1,
     "method": "getTimeDifference",
     "params": {
       "timestamp": "2024-02-08 12:30:00",
       "interval": "minutes"
     }
   }
   

   JSON-RPC レスポンスの例：

   // For a past timestamp (30 minutes ago)
   {
     "jsonrpc": "2.0",
     "id": 1,
     "result": {
       "difference": -30,
       "interval": "minutes",
       "inputTimestamp": "2024-02-08 12:30:00",
       "currentTime": "2024-02-08 13:00:00"
     }
   }
   
   // For a future timestamp (in 45 minutes)
   {
     "jsonrpc": "2.0",
     "id": 1,
     "result": {
       "difference": 45,
       "interval": "minutes",
       "inputTimestamp": "2024-02-08 13:45:00",
       "currentTime": "2024-02-08 13:00:00"
     }
   }
   

特長

• 現在時刻を YYYY-MM-DD HH:mm:ss 形式で取得
• タイムスタンプと現在時刻の時間差を計算
• 未来／過去の時刻を直感的に示す正負の値
• 分と秒の両方の間隔に対応
• Windows と macOS のクロスプラットフォーム対応
• シンプルな JSON-RPC インターフェイス
• 一貫性のある ISO 形式の日付表記
• 詳細なエラーメッセージによるエラー処理

インストール

npm install @dandeliongold/mcp-time

Claude Desktop での使用方法

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "time": {
      "command": "npx",
      "args": [
        "@dandeliongold/mcp-time"
      ]
    }
  }
}

開発

1. リポジトリをクローンします
2. 依存関係をインストールします

   npm install
   

3. テストを実行します

   npm test
   

4. 開発サーバーを起動します

   npm run dev
   

ライセンス

MIT ライセンスです。詳細はLICENSEを参照してください