Time & Location MCP Server

An MCP (Model Context Protocol) server that automatically detects and provides your current time and location information.

Features

• Auto-detection: Automatically detects your system timezone and location

• get_current_time: Returns current date/time in your local timezone

• get_location: Returns your location based on IP geolocation

Related MCP server: Time Server

Setup & Running

Using Docker Compose

# Build and run (will auto-detect timezone and location)
docker-compose up --build

# Run in background
docker-compose up -d

# Override location if needed
CITY="Seattle" PROVINCE="WA" COUNTRY="USA" docker-compose up

Manual Docker Build

# Build image
docker build -t time-mcp-server .

# Run with timezone mounting
docker run -it \
  -v /etc/localtime:/etc/localtime:ro \
  -v /etc/timezone:/etc/timezone:ro \
  time-mcp-server

MCP Client Configuration

For Cursor

1. Open Cursor Settings (Cmd+, on Mac or Ctrl+, on Windows/Linux)

2. Search for "Model Context Protocol" or navigate to Features > Beta

3. Enable MCP if not already enabled

4. Add this configuration:

{
  "mcpServers": {
    "time-location": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v", "/etc/localtime:/etc/localtime:ro",
        "-v", "/etc/timezone:/etc/timezone:ro",
        "time_mcp-time-mcp-server"
      ]
    }
  }
}

For Zed

1. Open Zed settings (Cmd+, on Mac)

2. Add to your settings.json:

{
  "assistant": {
    "version": "2",
    "provider": {
      "name": "anthropic"
    },
    "mcp": {
      "servers": {
        "time-location": {
          "command": "docker",
          "args": [
            "run",
            "--rm",
            "-i",
            "-v", "/etc/localtime:/etc/localtime:ro",
            "-v", "/etc/timezone:/etc/timezone:ro",
            "time_mcp-time-mcp-server"
          ]
        }
      }
    }
  }
}

Note: Make sure the Docker container is built first with docker-compose build

Tools Available

1. get_current_time

   • Automatically detects your system timezone

   • Returns current time with timezone info

   • Includes ISO format, Unix timestamp, and UTC offset

2. get_location

   • Uses IP-based geolocation (requires internet)

   • Falls back to environment variables if set

   • Returns city, province/state, country, and coordinates

Environment Variables (Optional)

Override auto-detection by setting these variables:

• TZ: Timezone (e.g., "America/New_York")

• CITY: Your city

• PROVINCE: Your province/state

• COUNTRY: Your country

• LATITUDE: Latitude coordinate

• LONGITUDE: Longitude coordinate