@strix-ai/currentdt
Advanced tools
A simple MCP tool that provides current date/time context to AI assistants in IDEs. strix-ai 🦉 - Wisdom in Every Line of Code
strix-ai 🦉
Wisdom in Every Line of Code
Engineered by AI, Empowering AI
A production-ready Model Context Protocol (MCP) tool that automatically provides current date and time context to AI assistants in supported IDEs. Now Available ✅
CurrentDT is a production-ready MCP server that seamlessly integrates with AI-powered IDEs (Cursor, VSCode, Claude, Windsurf, etc.) to provide real-time date and time context. When active, it automatically informs the AI assistant about the current date and time, enabling more accurate and time-aware responses.
✅ Live Production Status:
@strix-ai/currentdt on npm┌─────────────────────────────────────────────────────────────────┐
│ AI-Powered IDEs │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Cursor │ │ VSCode │ │ Claude │ │ Windsurf │ │
│ │ IDE │ │ + MCP Ext │ │ Desktop │ │ IDE │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│
┌───────────▼────────────┐
│ JSON-RPC 2.0 / MCP │
│ Protocol Layer │
└───────────┬────────────┘
│
┌───────────────────────▼────────────────────────┐
│ CurrentDT MCP Server │
│ │
│ ┌─────────────────┐ ┌─────────────────────┐ │
│ │ MCP Server │ │ DateTime Resource │ │
│ │ Core │◄─┤ Provider │ │
│ └─────────────────┘ └─────────────────────┘ │
│ │
│ ┌─────────────────┐ ┌─────────────────────┐ │
│ │ Time Sync │ │ Edge Case │ │
│ │ Service │ │ Handler │ │
│ └─────────────────┘ └─────────────────────┘ │
│ │
│ ┌─────────────────┐ ┌─────────────────────┐ │
│ │ Configuration │ │ Logger & │ │
│ │ Manager │ │ Validator │ │
│ └─────────────────┘ └─────────────────────┘ │
└────────────────────────────────────────────────┘
│
┌───────────────────────▼────────────────────────┐
│ Data Sources │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────┐ │
│ │ System Clock │ │ Network Time │ │ Timezone │ │
│ │ & Local │ │ Servers │ │ Database │ │
│ │ Timezone │ │ (NTP/HTTP) │ │ (Intl) │ │
│ └──────────────┘ └──────────────┘ └──────────┘ │
└─────────────────────────────────────────────────┘
📊 Auto-Injection Flow:
1️⃣ IDE sends any MCP request → 2️⃣ Server auto-updates datetime
3️⃣ Fresh context generated → 4️⃣ AI gets current datetime automatically
# Install globally via npm
npm install -g @strix-ai/currentdt
# Or install locally in your project
npm install @strix-ai/currentdt
# Start the MCP server (default configuration)
currentdt start
# Start with custom configuration
currentdt start --config ./my-config.json
# Check server status
currentdt status
# Stop the server
currentdt stop
Once installed, CurrentDT automatically integrates with supported IDEs. The AI assistant will have access to current datetime context in every conversation.
✅ Verified IDE Status:
Example of what the AI sees (Production):
🕒 Current DateTime Context (Auto-Updated)
═══════════════════════════════════════════════════════════════
📅 Local Time: 2024-08-20T11:30:25.123-05:00 (EST)
🌍 UTC Time: 2024-08-20T16:30:25.123Z
📍 Timezone: America/New_York (UTC-5, DST: Yes)
🔄 Last Updated: 2024-08-20T16:30:25.123Z
📊 Source: System Time (Health: Good)
═══════════════════════════════════════════════════════════════
This context is automatically refreshed on every AI interaction.
CurrentDT works with zero configuration but supports extensive customization.
{
"server": {
"host": "localhost",
"port": 3000,
"logLevel": "info",
"maxConnections": 10,
"timeoutMs": 5000
},
"datetime": {
"format": "iso",
"customFormat": null,
"timezones": ["local", "utc"],
"updateIntervalMs": 60000,
"includeMilliseconds": false
},
"privacy": {
"enabled": false,
"shareDate": true,
"anonymizeData": false,
"logTimestamps": true,
"logRetentionDays": 7
},
"timeSync": {
"enabled": false,
"servers": ["time.nist.gov", "worldtimeapi.org"],
"timeout": 5000,
"retryAttempts": 3,
"userConsent": true,
"fallbackToSystem": true
}
}
| Section | Option | Type | Default | Description |
|---|---|---|---|---|
| Server | host | string | "localhost" | MCP server bind address |
port | number | 3000 | MCP server port | |
logLevel | string | "info" | Logging level (debug, info, warn, error, silent) | |
maxConnections | number | 10 | Maximum concurrent connections | |
timeoutMs | number | 5000 | Request timeout in milliseconds | |
| DateTime | format | string | "iso" | DateTime format (iso, readable, custom) |
customFormat | string | null | Custom format string (when format="custom") | |
timezones | array | ["local", "utc"] | Timezones to include in context | |
updateIntervalMs | number | 60000 | Auto-update interval in milliseconds | |
includeMilliseconds | boolean | false | Include milliseconds in timestamps | |
| Privacy | enabled | boolean | false | Enable privacy mode (date-only sharing) |
shareDate | boolean | true | Share date information | |
anonymizeData | boolean | false | Anonymize timezone/location data | |
logTimestamps | boolean | true | Include timestamps in logs | |
logRetentionDays | number | 7 | Days to retain log files | |
| TimeSync | enabled | boolean | false | Enable network time synchronization |
servers | array | ["time.nist.gov", ...] | NTP/HTTP time servers | |
timeout | number | 5000 | Network timeout in milliseconds | |
retryAttempts | number | 3 | Number of retry attempts per server | |
userConsent | boolean | true | Require user consent for network access | |
fallbackToSystem | boolean | true | Fallback to system time if sync fails |
# Generate default configuration
currentdt config --init
# Edit configuration
currentdt config --edit
# Validate configuration
currentdt config --validate
# Override configuration with environment variables
CURRENTDT_ENABLED=true
CURRENTDT_FORMAT=readable
CURRENTDT_UPDATE_INTERVAL=30
CURRENTDT_PRIVACY_MODE=true
CURRENTDT_LOG_LEVEL=debug
{
"format": "custom",
"customFormat": "dddd, MMMM Do YYYY, h:mm:ss a"
}
When privacy mode is enabled, only the date (not time) is shared:
{
"privacyMode": true
}
Output in privacy mode:
Current Date Context:
- Local: 2024-01-15 (EST)
- UTC: 2024-01-15
{
"timezones": ["local", "utc", "America/New_York", "Europe/London", "Asia/Tokyo"]
}
✅ Working Status: Auto-discovery functioning, green status achieved
Setup:
npm install -g @strix-ai/currentdtcurrentdt startConfiguration File: Not required (auto-discovery working) ✅
Verification: ✅ TESTED
# Check if CurrentDT is running
currentdt status
# Expected: Green status in Cursor IDE
# Test datetime context - Open Cursor and ask: "What time is it right now?"
# Expected: AI will have current datetime context automatically
✅ Production Benefits:
✅ Working Status: Manual configuration method verified working
Setup:
npm install -g @strix-ai/currentdtConfiguration File: settings.json
{
"mcp.servers": {
"currentdt": {
"command": "currentdt",
"args": ["start"],
"env": {
"CURRENTDT_LOG_LEVEL": "info"
}
}
}
}
Alternative Configuration (with custom config):
{
"mcp.servers": {
"currentdt": {
"command": "node",
"args": [
"path/to/currentdt/dist/cli/index.js",
"--config", "path/to/your-config.json"
]
}
}
}
✅ Working Status: Configuration file method verified working
Setup:
npm install -g @strix-ai/currentdt~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonConfiguration File: claude_desktop_config.json
{
"mcpServers": {
"currentdt": {
"command": "currentdt",
"args": ["start"]
}
}
}
Advanced Configuration:
{
"mcpServers": {
"currentdt": {
"command": "currentdt",
"args": [
"start",
"--config", "~/.currentdt/config.json",
"--log-level", "debug"
],
"env": {
"CURRENTDT_PRIVACY_MODE": "true",
"CURRENTDT_UPDATE_INTERVAL": "30000"
}
}
}
}
✅ Working Status: MCP registration method verified working
Setup:
npm install -g @strix-ai/currentdtConfiguration File: Windsurf Settings → MCP Servers
{
"mcp": {
"servers": {
"currentdt": {
"command": "currentdt",
"args": ["start"],
"description": "Current DateTime Context Provider"
}
}
}
}
Generic Configuration Template:
{
"mcpServers": {
"currentdt": {
"command": "currentdt",
"args": ["start"],
"description": "strix-ai CurrentDT MCP Server",
"env": {
"NODE_ENV": "production"
}
}
}
}
Custom Binary Path:
{
"mcpServers": {
"currentdt": {
"command": "/usr/local/bin/node",
"args": [
"/usr/local/lib/node_modules/@strix-ai/currentdt/dist/cli/index.js",
"start"
]
}
}
}
| IDE | Setup Complexity | Auto-Discovery | Custom Config | Performance | Status |
|---|---|---|---|---|---|
| Cursor | ⭐ Very Easy | ✅ Working | ✅ Optional | ⭐⭐⭐⭐⭐ Excellent | ✅ Green Status |
| VSCode + MCP | ⭐⭐ Easy | ❌ Manual | ✅ Required | ⭐⭐⭐⭐ Very Good | ✅ Verified |
| Claude Desktop | ⭐⭐ Easy | ❌ Manual | ✅ Required | ⭐⭐⭐⭐ Very Good | ✅ Working |
| Windsurf | ⭐⭐⭐ Medium | ❌ Manual | ✅ Required | ⭐⭐⭐ Good | ✅ Tested |
| Generic MCP | ⭐⭐⭐ Medium | ❌ Manual | ✅ Required | ⭐⭐⭐ Good | ✅ Compatible |
# Server Configuration
export CURRENTDT_SERVER_HOST="localhost"
export CURRENTDT_SERVER_PORT="3000"
export CURRENTDT_SERVER_LOG_LEVEL="info"
# DateTime Configuration
export CURRENTDT_DATETIME_FORMAT="iso"
export CURRENTDT_DATETIME_UPDATE_INTERVAL="60000"
export CURRENTDT_DATETIME_TIMEZONES="local,utc"
# Privacy Configuration
export CURRENTDT_PRIVACY_ENABLED="false"
export CURRENTDT_PRIVACY_SHARE_DATE="true"
# Time Sync Configuration
export CURRENTDT_TIME_SYNC_ENABLED="false"
export CURRENTDT_TIME_SYNC_USER_CONSENT="true"
currentdt status
Output:
CurrentDT Status:
✅ Server: Running (PID: 12345)
🌍 Local Time: 2024-01-15T14:30:25-05:00
🌐 UTC Time: 2024-01-15T19:30:25Z
📡 Port: 3000
🔄 Update Interval: 60s
📊 Uptime: 2h 15m
# View logs
currentdt logs
# Follow logs in real-time
currentdt logs --follow
# Filter by log level
currentdt logs --level error
# Basic health check
curl http://localhost:3000/health
# Detailed health information
curl http://localhost:3000/health/detailed
CurrentDT only collects and shares:
⚠️ Important Privacy Notes:
privacyMode: true to share only dates, not precise timestimezones: ["utc"]# Test basic functionality
currentdt test
# Test with specific IDE
currentdt test --ide cursor
# Performance test
currentdt test --performance
currentdt start# Check if port is in use
netstat -an | grep 3000
# Try different port
currentdt start --port 3001
# Verify server is running
currentdt status
# Check IDE MCP configuration
currentdt config --ide-check
# Check system timezone
currentdt timezone --check
# Force timezone refresh
currentdt timezone --refresh
# Start in debug mode
currentdt start --debug
# Verbose logging
currentdt start --log-level debug
# Show help
currentdt --help
# Show version
currentdt --version
# Run diagnostics
currentdt diagnose
# Update to latest version
npm update -g @strix-ai/currentdt
# Check for updates
currentdt update --check
# Auto-update (if enabled)
currentdt update --auto
# Clean temporary files
currentdt clean
# Reset configuration to defaults
currentdt reset
# Backup configuration
currentdt backup
# Restore configuration
currentdt restore
We welcome contributions! Please see our Contributing Guide for details.
# Clone repository
git clone https://github.com/strix-ai/currentdt.git
cd currentdt
# Install dependencies
npm install
# Run tests
npm test
# Start development server
npm run dev
src/
├── core/ # Core MCP server implementation
├── datetime/ # DateTime handling logic
├── config/ # Configuration management
├── resources/ # MCP resource providers
├── cli/ # Command-line interface
├── utils/ # Utility functions
└── types/ # TypeScript type definitions
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ for the AI development community
FAQs
A simple MCP tool that provides current date/time context to AI assistants in IDEs. strix-ai 🦉 - Wisdom in Every Line of Code
The npm package @strix-ai/currentdt receives a total of 0 weekly downloads. As such, @strix-ai/currentdt popularity was classified as not popular.
We found that @strix-ai/currentdt demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Security News
Anthropic’s free OSS Scanner uses Mythos and other Claude models to find open source vulnerabilities and send maintainers reports with proposed fixes.
Security News
On Front Lines’ Early Adopters: CISO podcast, Andrew Becherer shares lessons from Datadog, weighs the long-term costs of AI-built tools, and explains how founders can actually gain a CISO’s trust.
Security News
/Product
Socket for Origin scans dependency changes in pull requests and flags security risks based on your team’s policies. Now available in Cursor’s App Marketplace.