MCP Time

🚀 @dandeliongold/mcp-time

An MCP server for getting the current time in ISO format (YYYY-MM-DD HH:mm:ss) using JavaScript Date. This server is suitable for the Claude desktop application and can run on both Windows and macOS.

🚀 Quick Start

This project is an MCP server that uses JavaScript Date to obtain the current time in ISO format. It is designed for the Claude desktop application and supports both Windows and macOS.

✨ Features

• Retrieve the current time.
• Calculate the difference between two timestamps.
• Support both minute and second units.

📦 Installation

npm install @dandelion/mcp-time

💻 Usage Examples

Basic Usage

Add the following content to config.json:

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

Advanced Usage

1. getCurrentTime

• Returns the current time in ISO format.
• No input parameters required.
• Return:

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

Example JSON-RPC request:

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

Example JSON-RPC response:

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

2. getTimeDifference

• Calculates the difference between the given timestamp and the current time.
• Parameters:
  • timestamp: ISO format timestamp (YYYY-MM-DD HH:mm:ss).
  • interval: 'minutes' (default) or 'seconds'.
• Returns a signed difference value following these conventions:
  • A positive value (+) indicates a future timestamp ("in X minutes/seconds").
  • A negative value (-) indicates a past timestamp ("X minutes/seconds ago").
  • Zero (0) indicates the same timestamp.

Example JSON-RPC request:

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

Example JSON-RPC responses:

// 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 12:30:00",
    "currentTime": "2024-02-08 13:15:00"
  }
}

🔧 Development

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Run tests:

npm test

4. Start the development server:

npm start

📄 License

This project is licensed under the MIT License.