@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 [email protected]

License

MIT License - see LICENSE file for details.

---

Made with ❤️ by Biswajit Panday