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

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

Open Cursor Settings (Cmd+, on Mac or Ctrl+, on Windows/Linux)
Search for "Model Context Protocol" or navigate to Features > Beta
Enable MCP if not already enabled
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

Open Zed settings (Cmd+, on Mac)
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

get_current_time
- Automatically detects your system timezone
- Returns current time with timezone info
- Includes ISO format, Unix timestamp, and UTC offset
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

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

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

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

Enable MCP if not already enabled

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

Open Zed settings (Cmd+, on Mac)

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

get_current_time

Automatically detects your system timezone
Returns current time with timezone info
Includes ISO format, Unix timestamp, and UTC offset

get_location

Uses IP-based geolocation (requires internet)
Falls back to environment variables if set
Returns city, province/state, country, and coordinates