A
securityF
licenseA
qualityA Model Context Protocol server that provides time and timezone conversion capabilities, enabling LLMs to get current time information and perform timezone conversions using IANA timezone names.
MCP-WTIT (What Time Is It?)
A Model Context Protocol (MCP) server that provides current time in ISO8601 format with timezone support.
🚀 Features
⏰ Get current time with detailed information (ISO8601, timestamp, timezone)
🌍 Support for all IANA timezones
🎯 Optional milliseconds precision
🏗️ Clean Architecture design
📦 ESModules with TypeScript 5.6+
✅ Comprehensive test coverage
🔧 Type-safe with strict TypeScript configuration
📋 Requirements
Node.js 18.0.0 or higher
npm or yarn
🛠️ Installation
As a global package
# Install globally
npm install -g mcp-wtit
# Run the server
mcp-wtit
As a dependency
# Install as a dependency
npm install mcp-wtit
From source
# Clone the repository
git clone https://github.com/yorifuji/mcp-wtit.git
cd mcp-wtit
# Install dependencies
npm install
# Build the project
npm run build
# Run the server
npm start
🚦 Quick Start
For MCP Clients (Claude Desktop, etc.)
Add to your MCP client configuration:
If installed globally:
{
"mcpServers": {
"mcp-wtit": {
"command": "mcp-wtit"
}
}
}
If installed locally:
{
"mcpServers": {
"mcp-wtit": {
"command": "node",
"args": ["./node_modules/mcp-wtit/dist/index.js"]
}
}
}
From source:
{
"mcpServers": {
"mcp-wtit": {
"command": "node",
"args": ["/path/to/mcp-wtit/dist/index.js"]
}
}
}
Debug with MCP Inspector
MCP Inspector provides a web-based interface to test and debug your MCP server:
# Build the project first
npm run build
# Run with MCP Inspector
npm run inspect
This will:
Start the MCP Inspector on http://localhost:6274
Automatically open your browser
Connect to the MCP server with debug capabilities
In the Inspector, you can:
View available tools and their schemas
Test tool calls with different parameters
Monitor request/response communication
Debug server behavior in real-time
For Development
# Run in development mode
npm run dev
# Run tests
npm test
# Run tests with coverage
npm run test:coverage
# Lint code
npm run lint
# Type check
npm run typecheck
📚 API Documentation
Tools
get_current_time
Get the current time with detailed information.
Parameters:
includeMilliseconds(boolean, optional): Include milliseconds in ISO8601 format (default: true)timezone(string, optional): Timezone for the time (default: "UTC")
Response:
{
"iso8601": "2024-01-15T10:30:45.123Z",
"timestamp": 1705315845123,
"timezone": "UTC"
}
🏛️ Architecture
This project follows Clean Architecture principles:
src/
├── domain/ # Business logic (no dependencies)
├── application/ # Use cases
├── infrastructure/ # External interfaces (MCP)
├── shared/ # Shared types and utilities
└── di/ # Dependency injection
See Architecture Documentation for details.
🧪 Testing
Tests are located in the tests/ directory and use Vitest:
# Run all tests
npm test
# Run tests in watch mode
npm run test:watch
# Generate coverage report
npm run test:coverage
📦 Scripts
Script | Description |
| Build the TypeScript project |
| Run in development mode |
| Run the built server |
| Debug with MCP Inspector |
| Run tests |
| Run tests in watch mode |
| Run tests with coverage report |
| Run ESLint |
| Run ESLint and fix issues |
| Run TypeScript type checking |
🤝 Contributing
Fork the repository
Create your feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add some amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
Built for the Model Context Protocol
Inspired by Clean Architecture principles
📦 NPM Package
Published on npm: mcp-wtit
Tools
A Model Context Protocol server that provides current time in ISO8601 format with timezone support.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server for time manipulation tasks, enabling AI models to get the current date/time and calculate duration between timestamps.Last updated -72MIT License
- -securityFlicense-qualityA simple Model Context Protocol (MCP) server that provides date and time functionality in any timezone, along with user profiles and personalized greeting resources.Last updated -
- AsecurityFlicenseAqualityA Model Context Protocol server that provides tools to get the current date and time in various formats, supporting different timezones and custom formatting options.Last updated -17