WorldTime

WorldTime MCP Server is a lightweight service that serves the current time for a given area by querying WorldTime API and TimezoneDB. It is useful when you want a centralized time lookup for locations in your MCP ecosystem and you gain access to a TimezoneDB API key for broader timezone support.

How to use

To use this server, run it locally and configure your MCP client to connect to the local process. You will provide your TimezoneDB API key so the server can access a wide range of timezones.

How to install

Prerequisites you need before installing
- Node.js installed on your machine (LTS version recommended)
- npm (comes with Node.js) available in your path

Installation steps
- Ensure you have a TimezoneDB API key ready to use in your environment
- Install dependencies for the MCP server
- Build the project if a build step exists
- Run the server with the proper environment variables and the final start command

Follow these commands in order to set up and run the server.

Configuration and usage notes

The server is started as a local process. You provide the path to the runtime script and an environment variable for your TimezoneDB API key so the server can access timezone data.

Configuration example

{
  "mcpServers": {
    "worldtime": {
      "command": "node",
      "args": ["/Users/<your-username>/worldtime-mcp-server/dist/index.js"],
      "env": {
        "TIMEZONE_DB_API_KEY": "<your-timezone-db-api-key>"
      }
    }
  }
}

Start and run commands

A typical start flow after dependencies are installed is to run the Node script that starts the MCP server. Ensure your TIMEZONE_DB_API_KEY is set in the environment when you start the process.

Notes

If you need to debug, you can run an inspector tool or debugging command as described in your environment to verify the MCP connection and data flow.

Security and access

Keep your TimezoneDB API key secure. Do not commit it to source control and load it only from trusted environment configurations in your runtime environment.