🚀 Chronos MCP (Model Context Protocol) Server

A time-related server implementing the Model Context Protocol (MCP). It provides timezone-aware date and time information through a simple MCP interface.

🚀 Quick Start

The Chronos MCP server is a time - related server built with .NET Core. It implements the Model Context Protocol (MCP) and offers timezone - aware date and time information via a straightforward MCP interface.

✨ Features

Retrieve the current date and time for any supported timezone.
Configure the default timezone via appsettings.json and environment variables.
Handle errors for invalid timezone requests.

📦 Installation

Prerequisites

.NET 9.0 (for local development/deployment)
Docker (for container deployment)

Development Build Instructions

If you want to build the project from source code:

Clone this repository:

git clone https://github.com/aadversteeg/chronos-mcp-server.git

Navigate to the project root directory:
```
cd chronos-mcp-server
```
Build the project:
```
dotnet build src/chronos.sln
```
Run the tests:
```
dotnet test src/chronos.sln
```

🐳 Docker Support

DockerHub Image

The Chronos MCP server is available on DockerHub at aadversteeg/chronos-mcp-server.

# Pull the latest version
docker pull aadversteeg/chronos-mcp-server:latest

# Or pull a specific version
docker pull aadversteeg/chronos-mcp-server:<version>

Build and Run with Docker

To build and run from source code:

Clone the repository:

git clone https://github.com/aadversteeg/chronos-mcp-server.git

Enter the directory:
```
cd chronos-mcp-server/Docker
```
Build and run using the following command:
```
docker-compose up --build
```

The server will be available at http://localhost:5000.

⚙️ Configure Claude Desktop

Using Local Installation

To configure Claude Desktop to use the locally installed Chronos server:

Add the server configuration to the mcpServers section of the Claude Desktop configuration file:

"chronos": {
  "command": "dotnet",
  "args": [
    "YOUR_PATH_TO_DLL\\Core.Infrastructure.McpServer.dll"
  ],
  "env": {
    "DefaultTimeZoneId": "Europe/Amsterdam"
  }
}

Save the file and restart Claude Desktop.

Using Docker Container

To use the Chronos server from a Docker container with Claude Desktop:

Add the server configuration to the mcpServers section of the Claude Desktop configuration file:

"chronos": {
  "command": "docker",
  "args": [
    "run",
    "--rm",
    "-i", 
    "-e", "DefaultTimeZoneId=Europe/Amsterdam",
    "aadversteeg/chronos-mcp-server:latest"
  ]
}