@strix-ai/currentdt-mcp

Real-time date and time access for AI assistants via Model Context Protocol (MCP)

Built for AI, Built with AI - Enhancing AI assistant capabilities through intelligent tooling

📑 Table of Contents

• Overview

• Quick Start

• User Flow

• Core Features

• MCP Client Integration

• Real-World Usage Examples

• API Reference

• Configuration

• Common Format Patterns

• Troubleshooting

• Development

• Documentation

• Support & Links

• Contributing

• License

Overview

@strix-ai/currentdt-mcp is an MCP server that provides AI assistants with instant access to current date and time information. Essential for generating timestamped code, migration files, and dated documentation.

Quick Start

# Install globally
npm install -g @strix-ai/currentdt-mcp

# Configure your MCP client (see integration guides below)
# Start using current datetime in AI conversations!

User Flow

┌─────────────────────┐    ┌─────────────────┐    ┌─────────────────────┐
│ User Asks for       │───▶│ AI Assistant    │───▶│ get_current_        │
│ Timestamped Code    │    │                 │    │ datetime Tool       │
└─────────────────────┘    └─────────────────┘    └─────────────────────┘
                                                            │
                                                            ▼
┌─────────────────────┐    ┌─────────────────┐    ┌─────────────────────┐
│ Timestamped Output  │◀───│ Current Time    │◀───│ CurrentDT MCP       │
│ Generated           │    │ Returned        │    │ Server              │
└─────────────────────┘    └─────────────────┘    └─────────────────────┘
                                                            │
                                                            ▼
                           ┌─────────────────┐    ┌─────────────────────┐
                           │ Formatted       │◀───│ Local/Remote        │
                           │ DateTime        │    │ Time Provider       │
                           └─────────────────┘    └─────────────────────┘

Core Features

• Zero Configuration - Works immediately after installation

• Multiple Formats - ISO 8601, custom formats (YYYY-MM-DD, MM/DD/YYYY, etc.)

• Provider System - Local system clock with remote fallback

• MCP Compatible - Cursor, Claude Desktop, VS Code, Windsurf

• TypeScript Native - Full type safety and IntelliSense

MCP Client Integration

Cursor IDE

npm install -g @strix-ai/currentdt-mcp

Add to ~/.cursor/mcp_servers.json:

{
  "mcpServers": {
    "currentdt": {
      "command": "npx",
      "args": ["@strix-ai/currentdt-mcp"]
    }
  }
}

Claude Desktop

npm install -g @strix-ai/currentdt-mcp

Add to ~/claude_desktop_config.json:

{
  "mcpServers": {
    "currentdt": {
      "command": "currentdt-mcp",
      "args": []
    }
  }
}

VS Code (with MCP Extension)

Install package and configure via MCP extension settings or add to VS Code settings:

{
  "mcp.servers": [
    {
      "name": "currentdt", 
      "command": "currentdt-mcp"
    }
  ]
}

Windsurf

Same configuration as Cursor IDE - add to Windsurf MCP settings file.

Real-World Usage Examples

1. SQL Migration Files

User: "Create a migration to add user preferences table"
Result: Migration file named 2025-08-26-143000_add_user_preferences.sql with current timestamp

MCP Tool Call Example:

{
  "tool": "get_current_datetime",
  "arguments": {
    "format": "YYYY-MM-DD-HHmmss",
    "provider": "local"
  }
}

2. Timestamped Logging

User: "Generate a logger that includes timestamps"
Result: Logger implementation with current ISO datetime format

3. Dated Documentation

User: "Update the changelog with today's date"
Result: Changelog entry with current date: ## [1.1.7] - 2025-08-26

API Reference

Tool: get_current_datetime

Parameters:

• format (optional): "iso" (default) or custom format like "YYYY-MM-DD HH:mm:ss"

• provider (optional): "local" (default) or "remote"

Returns: Formatted datetime string

Example:

{
  "tool": "get_current_datetime",
  "arguments": {
    "format": "YYYY-MM-DD HH:mm:ss",
    "provider": "local"
  }
}

Configuration (Optional)

Create currentdt-config.json for custom settings:

{
  "defaultFormat": "iso",
  "defaultProvider": "local",
  "providers": {
    "local": {
      "name": "local",
      "enabled": true,
      "priority": 1
    },
    "remote": {
      "name": "remote",
      "enabled": false,
      "priority": 2,
      "config": {
        "url": "https://worldtimeapi.org/api/timezone/UTC",
        "timeout": 5000
      }
    }
  },
  "customFormats": {
    "filename": "YYYY-MM-DD-HHmmss",
    "simple": "MM/DD/YYYY"
  },
  "cache": {
    "enabled": true,
    "ttl": 1000
  }
}

Common Format Patterns

• "iso" → 2025-08-26T14:30:00.000Z

• "YYYY-MM-DD" → 2025-08-26

• "YYYY-MM-DD HH:mm:ss" → 2025-08-26 14:30:00

• "MM/DD/YYYY" → 08/23/2025

• "YYYY-MM-DD-HHmmss" → 2025-08-26-143000

Troubleshooting

Tool Not Available

# Verify installation
npm list -g @strix-ai/currentdt-mcp

# Test server directly
npx @strix-ai/currentdt-mcp --test

Debug Mode

export CURRENTDT_DEBUG=true
npx @strix-ai/currentdt-mcp

Development

git clone https://github.com/biswajitpanday/CurrentDT-mcp.git
cd currentdt-mcp
npm install
npm run dev

npm Scripts

• npm run build - Build TypeScript

• npm test - Run all tests

• npm run lint - ESLint check

• npm run format - Prettier format

Documentation

Detailed documentation available in /docs:

• TaskList.md - Development progress tracking

• Architecture.md - System architecture and design

• SRS.md - Software requirements specification

• PRD.md - Product requirements document

Contributing

1. Fork the repository

2. Create a feature branch: git checkout -b feature/amazing-feature

3. Commit changes: git commit -m 'Add amazing feature'

4. Push to branch: git push origin feature/amazing-feature

5. Open a Pull Request

Support & Links

• Issues: GitHub Issues

• Documentation: GitHub Repository

• npm Package: @strix-ai/currentdt-mcp

• Author: Biswajit Panday - AI-Assisted Development Enthusiast

• Contributor: Abdullah Saleh Robin robinabdullah@yahoo.com

License

MIT License - see LICENSE file for details.

Made with ❤️ by Biswajit Panday