A
securityA
licenseA
qualityAn MCP server that allows checking local time on the client machine or current UTC time from an NTP server
Last updated -
2
25
MIT License
MCP Current Time Server
A minimal Model Context Protocol (MCP) server that provides current local datetime information. This server serves as a blueprint for building simple, single-purpose MCP servers.
Features
current-time: Get current local datetime in a simple single-line format
Quick Start
Prerequisites
Bun runtime
Installation
# Clone and navigate to project
git clone <repository-url>
cd mcp-datetime
# Install dependencies
bun install
# Make executable
chmod +x src/index.ts
Run Server
bun run src/index.ts
Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):
{
"mcpServers": {
"datetime": {
"command": "bun",
"args": ["/absolute/path/to/mcp-datetime/src/index.ts"]
}
}
}
VS Code MCP Extension
{
"mcp": {
"servers": {
"datetime": {
"command": "bun",
"args": ["/absolute/path/to/mcp-datetime/src/index.ts"]
}
}
}
}
Usage Example
{
"tool": "current-time",
"parameters": {
"timezone": "America/New_York"
}
}
Response:
Monday, January 15, 2024 at 2:30:45 PM EST
Development
Scripts
# Run server
bun run src/index.ts
# Run tests
bun test
# Build for production
bun build src/index.ts --outdir=dist
Project Structure
src/
├── index.ts # Main entry point
├── server/
│ └── datetime-server.ts # MCP server configuration
├── tools/
│ ├── current-time.ts # Current time tool
│ └── current-time.test.ts # Unit tests
├── utils/
│ └── datetime-utils.ts # Shared utilities
└── types/
└── datetime.types.ts # Type definitions
Extending This Blueprint
This minimal server is designed to be easily extended:
Add new tools: Create
src/tools/new-tool.tsand register indatetime-server.tsAdd resources: Create
src/resources/new-resource.tsand register indatetime-server.tsAdd validation: Use Zod schemas for input validation
Add tests: Create
.test.tsfiles alongside your tools
Testing
Run the test suite:
bun test
Troubleshooting
Common Issues
Permission Denied: Make sure
src/index.tsis executablechmod +x src/index.tsTimezone Issues: Ensure valid IANA timezone identifiers are used
License
MIT License - see LICENSE file for details.
This server cannot be installed
Related Resources
Related MCP Servers
- -securityFlicense-qualityAn MCP server providing timezone conversions and time-related operations via RESTful API endpoints, featuring comprehensive error handling and timezone database integration.Last updated -
- -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 -
- Asecurity-licenseAqualityA 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 -14