Skip to content

pinkpixel-dev/datetime-mcp

Repository files navigation

@pinkpixel/datetime-mcp MCP Server ⏰

smithery badge

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.

Features ✨

Tools

  • 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.

Installation 🚀

There are two ways to install and configure this MCP server:

Installing via Smithery

To install datetime-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @pinkpixel-dev/datetime-mcp --client claude

1. Installation from NPM (Recommended)

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)

2. Local Development Setup

If you want to run the server directly from a cloned repository for development or testing:

  1. Clone the repository:

    # git clone https://github.com/pinkpixel/datetime-mcp.git
    cd datetime-mcp
  2. Install dependencies:

    npm install
  3. Build the server:

    npm run build
  4. 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)

Debugging 🐞

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.

License 📄

MIT License - Copyright (c) 2025 Pink Pixel

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •