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

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