JinDaGe - mcp-time MCP Details

article

README

🚀 @dandeliongold/mcp-time

这是一个用于获取当前时间ISO格式（YYYY-MM-DD HH:mm:ss）的MCP服务器，借助JavaScript Date实现。该服务器适用于Claude桌面应用程序，可在Windows和macOS系统上运行。

🚀 快速开始

本项目提供了便捷的时间获取和时间差计算功能，以下是简单的使用说明：

安装依赖：

npm install @dandelion/mcp-time

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

📚 详细文档

组件

工具

getCurrentTime
- 功能：返回当前时间的ISO格式。
- 参数：无。
- 返回值：

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

getTimeDifference
- 功能：计算给定时间戳与当前时间之间的差异。
- 参数：
  - timestamp：ISO格式时间戳（YYYY-MM-DD HH:mm:ss）。
  - interval：'分钟'（默认）或 '秒'。
- 返回值：一个带符号的差异值，遵循以下约定：
  - 正值（+）表示未来时间戳（"在X分钟后/秒后"）。
  - 负值（-）表示过去时间戳（"X分钟后/秒前"）。
  - 零（0）表示相同时间戳。

在Claude桌面应用程序中的使用

在config.json中添加以下内容：

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

🔧 技术细节

开发流程

克隆仓库：

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

安装依赖：

npm install

运行测试：

npm test

启动开发服务器：

npm start

📄 许可证

此项目受MIT许可证保护。

mcp-time