Chronos MCP Server

🚀 Chronos MCP 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 built with .NET Core and is based on the Model Context Protocol C# SDK (github.com/modelcontextprotocol/csharp-sdk). It offers tools to access date and time information in different time zones. This lightweight server demonstrates how to create a practical custom MCP server and can be deployed on a local machine or in a Docker container.

✨ Features

• Retrieve the current date and time in any supported timezone.
• Configure the default timezone via appsettings.json and environment variables.
• Implement error handling for invalid timezone requests.

📦 Installation

Prerequisites

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

Development Build Instructions

To build the project from source code:

1. Clone this repository:

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

2. Navigate to the project root directory:

cd chronos-mcp-server

3. Build the project:

dotnet build src/chronos.sln

4. 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:

1. Clone the repository:

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

2. Enter the directory:

cd chronos-mcp-server/Docker

3. Build and run using the following command:

docker-compose up --build

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

Configuration for Claude Desktop

Using Local Installation

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

1. 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"
  }
}

2. Save the file and restart Claude Desktop.

Using Docker Container

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

1. 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"
  ]
}

2. Save the file and restart Claude Desktop.

📄 License

This project is licensed under the MIT License. For more details, see the LICENSE file.