DateTime MCP Server
A Model Context Protocol (MCP) server that returns current user's timezone date and time
Features
returns current user's timezon date and time
Installation
Clone or download this repository
Install dependencies:
Build the server:
Testing and Debugging
1. MCP Inspector (Recommended)
The easiest way to test your MCP server interactively:
This will open a web interface where you can:
See all available tools
Test the
datetimetoolInspect requests and responses
2. VSCode Debugging
Use the built-in VSCode debugger with the provided launch configurations:
Press
F5or go to Run → Start DebuggingChoose "Debug MCP with Inspector" to debug with the web interface
Choose "Debug MCP Server" to debug the server directly
Set breakpoints in your code to step through execution
3. Manual Testing
Run the test script:
4. Development Mode
Build automatically on file changes:
In another terminal, run the inspector:
Common Issues
Exit Code 1: Make sure to run
npm run buildfirstPort in use: Close other inspector instances
Module errors: Verify
"type": "module"is in package.json
Configuration
Add the server to your MCP configuration:
For VSCode (Claude Dev Extension):
For Claude Desktop:
Usage
The server provides a single tool named datetime with no parameters:
Example usage:
Example response:
Contributing
Feel free to submit issues and enhancement requests!