# mcp-timer-server

A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that provides accurate system time to LLM applications via a simple tool call.

## Features

- **Real-time data**: Provides the current date and time from the host machine
- **Multi-timezone support**: Query time in any supported IANA timezone
- **Zero dependencies at runtime**: Uses only Node.js built-in Intl API
- **Stdio transport**: Works with any MCP-compatible client

## Installation

Clone and install locally:

```bash
git clone https://github.com/scotty-phillips/mcp-timer-server.git
cd mcp-timer-server
npm install
```

## Usage with LM Studio

1. Open LM Studio and go to the **Developer** tab (MCP section)

2. Add a new MCP server configuration pointing to your local installation:

```json
{
  "mcpServers": {
    "timer": {
      "command": "node",
      "args": ["C:\\Users\\scott\\system-time-mcp\\index.js"]
    }
  }
}
```

> **Note**: Update the path to match where you clone the repo. Use forward slashes or escape backslashes in Windows paths.

## Available Tools

### `get_system_time`

Returns the current accurate system date and time from the local workstation.

**Input Parameters:** None required.

**Example Response:**

```
The current time on this workstation is: Wednesday, June 13, 2026, 7:05 PM (Australian Eastern Summer Time)
```

> **Note**: For timezone-aware time with more IANA timezone options, use the enhanced version at `src/index.js` which supports a `timezone` parameter.

## Usage with Other Clients

For other MCP-compatible clients, point the server configuration to your local `node` executable and the path to `index.js`.

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "timer": {
      "command": "node",
      "args": ["C:/path/to/system-time-mcp/src/index.js"]
    }
  }
}
```

### Cursor

Add to your Cursor MCP settings:

```json
{
  "mcpServers": {
    "timer": {
      "command": "node",
      "args": ["C:/path/to/system-time-mcp/src/index.js"]
    }
  }
}
```

## Development

### Running Locally

```bash
npm start
```

### Running Tests

```bash
npm test
```

### Help

The server runs via stdio and responds to tool calls from any MCP client.

## Project Structure

```
mcp-timer-server/
├── src/
│   └── index.js      # Enhanced version with timezone support
├── tests/
│   └── index.test.js # Basic test suite
├── .gitignore
├── LICENSE
├── README.md
└── package.json
```

## License

[MIT](LICENSE) - Copyright (c) 2026 Scott Phillips

## Author

Scott Phillips  
GitHub: [scotty-phillips](https://github.com/scotty-phillips)

[![Buy Me A Coffee](https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png)](https://www.buymeacoffee.com/rgkwqyt)