@dandeliongold/mcp-time

@dandeliongold/mcp-time

一个 MCP 服务，可使用 JavaScript Date 获取 ISO 格式（YYYY-MM-DD HH:mm:ss）的当前时间。此服务可在 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