MCP Time

🚀 @dandeliongold/mcp-time

這是一個用於獲取當前時間ISO格式（YYYY-MM-DD HH:mm:ss）的MCP服務器，藉助JavaScript Date實現。該服務器適用於Claude桌面應用程序，可在Windows和macOS系統上運行。

🚀 快速開始

本項目提供了便捷的時間獲取和時間差計算功能，以下是簡單的使用說明：

1. 安裝依賴：

npm install @dandelion/mcp-time

2. 在Claude桌面應用程序的config.json中添加配置：

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

✨ 主要特性

• 能夠獲取當前時間。
• 可以計算兩個時間戳之間的差異。
• 支持以分鐘和秒為單位進行計算。

📦 安裝指南

使用以下命令安裝本項目：

npm install @dandelion/mcp-time

💻 使用示例

基礎用法

getCurrentTime

該工具用於返回當前時間的ISO格式，無需輸入參數。 示例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

該工具用於計算給定時間戳與當前時間之間的差異。 示例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"
  }
}

📚 詳細文檔

組件

工具

1. getCurrentTime
   • 功能：返回當前時間的ISO格式。
   • 參數：無。
   • 返回值：

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

2. getTimeDifference
   • 功能：計算給定時間戳與當前時間之間的差異。
   • 參數：
     • timestamp：ISO格式時間戳（YYYY-MM-DD HH:mm:ss）。
     • interval：'分鐘'（默認）或 '秒'。
   • 返回值：一個帶符號的差異值，遵循以下約定：
     • 正值（+）表示未來時間戳（"在X分鐘後/秒後"）。
     • 負值（-）表示過去時間戳（"X分鐘後/秒前"）。
     • 零（0）表示相同時間戳。

在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許可證保護。