A simple MCP server that provides LLMs with the current date and time context based on the server's system clock.
This is a TypeScript-based MCP server that demonstrates a basic tool implementation for the Model Context Protocol.
get_current_datetime
: Returns the current date and time of the server as an ISO 8601 formatted string (e.g.,2025-04-05T22:30:00.000Z
).- Takes no input parameters.
There are two ways to install and configure this MCP server:
To install datetime-mcp for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @pinkpixel-dev/datetime-mcp --client claude
Install the package globally using npm:
npm install -g @pinkpixel/datetime-mcp
Then, add the following configuration to your MCP client's settings file.
{
"mcpServers": {
"datetime": {
"command": "npx",
"args": [
"-y",
"@pinkpixel/datetime-mcp"
],
"disabled": false,
"alwaysAllow": [
"get_current_datetime"
]
}
}
}
(Restart your MCP client application after updating the settings)
If you want to run the server directly from a cloned repository for development or testing:
-
Clone the repository:
# git clone https://github.com/pinkpixel/datetime-mcp.git cd datetime-mcp
-
Install dependencies:
npm install
-
Build the server:
npm run build
-
Add the following configuration to your MCP client's settings file, making sure to replace
/path/to/datetime-mcp
with the actual absolute path to where you cloned the repository:{ "mcpServers": { "datetime-local": { "command": "node", "args": ["/path/to/datetime-mcp/build/index.js"], "disabled": false, "alwaysAllow": [ "get_current_datetime" ] } } }
(Restart your MCP client application after updating the settings)
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspector
The Inspector will provide a URL to access debugging tools in your browser.
MIT License - Copyright (c) 2025 Pink Pixel