mcpField
@
@dandeliongold/mcp-time

@dandeliongold/mcp-time

Local
github.com/dandeliongoldProductivity3Updated 90w ago
Repository

About @dandeliongold/mcp-time

@dandeliongold/mcp-time is a small MCP server for retrieving the current time and comparing a timestamp with now. It is intended for MCP clients such as the Claude desktop app on Windows and macOS.

Key features

  1. 01Get the current time in ISO-style format
  2. 02Compare a timestamp with the current time
  3. 03Return differences in minutes or seconds
  4. 04Indicate past and future with signed values

Use cases

  1. 01Include the current time in an assistant response
  2. 02Calculate how long ago an event occurred
  3. 03Determine how long until a scheduled time

MCP support

Exposes current-time and time-difference tools to MCP clients. The README describes use with the Claude desktop app.

#mcp#claude#model-context-protocol#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "time": {
      "command": "npx",
      "args": [
        "-y",
        "@dandeliongold/mcp-time"
      ]
    }
  }
}
Run commandnpx -y @dandeliongold/mcp-time

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@dandeliongold/mcp-time

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

@dandeliongold/mcp-time

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

Components

Tools

  1. getCurrentTime

    • Returns the current time in ISO format
    • No input parameters required
    • Returns: 
      {
  "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 time difference between a 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 this convention:
      • Positive values (+) indicate future timestamps ("in X minutes/seconds")
      • Negative values (-) indicate past timestamps ("X minutes/seconds ago")
      • Zero (0) indicates 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 13:45:00",
    "currentTime": "2024-02-08 13:00:00"
  }
}

Features

  • Get current time in YYYY-MM-DD HH:mm:ss format
  • Calculate time differences between timestamps and current time
  • Intuitive positive/negative values for future/past times
  • Support for both minutes and seconds intervals
  • Cross-platform support for Windows and macOS
  • Simple JSON-RPC interface
  • Consistent ISO-style date formatting
  • Error handling with detailed error messages

Installation

npm install @dandeliongold/mcp-time

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "time": {
      "command": "npx",
      "args": [
        "@dandeliongold/mcp-time"
      ]
    }
  }
}

Development

  1. Clone the repository
  2. Install dependencies 
    npm install
  3. Run tests 
    npm test
  4. Start development server 
    npm run dev

License

MIT License - see LICENSE for details

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.