MCP Time

🚀 @dandeliongold/mcp-time

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

✨ 主な機能

• 現在の時間を取得する
• 2つのタイムスタンプ間の差分を計算する
• 分と秒の単位をサポートする

📦 インストール

npm install @dandelion/mcp-time

💻 使用例

基本的な使用法

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
  }
}

getTimeDifference

• 与えられたタイムスタンプと現在の時間の差分を計算します。
• パラメーター：
  • timestamp: ISO形式のタイムスタンプ（YYYY-MM-DD HH:mm:ss）
  • interval: '分'（デフォルト）または '秒'
• 符号付きの差分値を返し、以下の規則に従います：
  • 正の値（+）は未来のタイムスタンプを表します（"X分後/秒後"）
  • 負の値（-）は過去のタイムスタンプを表します（"X分前/秒前"）
  • ゼロ（0）は同じタイムスタンプを表します

JSON-RPCリクエストの例：

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

JSON-RPCレスポンスの例：

// 過去のタイムスタンプの場合（30分前）
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "difference": -30,
    "interval": "minutes",
    "inputTimestamp": "2024-02-08 12:30:00",
    "currentTime": "2024-02-08 13:00:00"
  }
}

// 未来のタイムスタンプの場合（45分後）
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "difference": 45,
    "interval": "minutes",
    "inputTimestamp": "2024-02-08 12:30:00",
    "currentTime": "2024-02-08 13:15:00"
  }
}

Claudeデスクトップアプリケーションでの使用

config.jsonに以下の内容を追加します：

{
  "modules": {
    "time": {
      "url": "http://localhost:3000",
      "type": "mcp"
    }
  }
}

📚 ドキュメント

開発手順

1. リポジトリをクローンする：

git clone https://github.com/your-username/dandelion.git
cd dandelion/packages/mcp-time

2. 依存関係をインストールする：

npm install

3. テストを実行する：

npm test

4. 開発サーバーを起動する：

npm start

📄 ライセンス

このプロジェクトはMITライセンスの下で保護されています。