What is Horologic Mcp

Horologic MCP is a reliable Model Context Protocol (MCP) server designed for time and timezone operations, developed using TypeScript. It integrates seamlessly with Claude Desktop and other MCP-compatible clients, providing similar functionalities as the Python time reference server.

Use cases

Use cases for Horologic MCP include integrating time services in AI assistants, developing applications that require timezone conversions, and enhancing functionalities in software that deals with international time management.

How to use

To use Horologic MCP, install the necessary dependencies and build the project using npm. Configure your AI assistant by adding the server details to the respective configuration files for Claude Desktop, Cursor, or Cline/RooCoder. Restart your AI assistant to access the Horologic MCP tools.

Key features

Key features include tools for retrieving the current time in any IANA timezone, converting times between IANA timezones with daylight saving handling, full compliance with the latest MCP specifications, and a type-safe TypeScript implementation with modern JavaScript features.

Where to use

Horologic MCP can be used in various applications that require accurate time and timezone management, such as scheduling systems, event planning tools, and any software needing time-related functionalities.

Horologic MCP

TypeScript Model Context Protocol (MCP) Time Server by Yoda Digital

Horologic MCP is a reliable Model Context Protocol (MCP) server for time and timezone operations, built with TypeScript. It provides seamless integration with Claude Desktop and other MCP-compatible clients, offering the same functionality as the Python time reference server.

Key Features

• Time & Timezone Tools:
  • get_current_time: Retrieve the current time in any IANA timezone
  • convert_time: Convert times between any two IANA timezones with daylight saving handling
• MCP Protocol Compliance:
  • Full support for the latest MCP specifications
  • Integrates with Claude Desktop and other MCP clients
  • Uses STDIO transport for local, secure operation
• TypeScript Implementation:
  • Type-safe codebase with modern JavaScript features
  • Modular design with comprehensive error handling
  • Consistent with the Python reference implementation

Quick Start

1. Install dependencies and build:

   npm install
   npm run build
   

2. Configure your AI assistant:

   For Claude Desktop:
   Add the following to your claude_desktop_config.json:

   {
     "mcpServers": {
       "horologic-mcp": {
         "command": "node",
         "args": [
           "/absolute/path/to/horologic-mcp/dist/index.js"
         ]
       }
     }
   }
   

   For Cursor:
   Go to Settings > Features > MCP and add a new server:

   • Type: stdio
   • Name: horologic-mcp
   • Command: node /absolute/path/to/horologic-mcp/dist/index.js

   For Cline/RooCoder:
   Add a new MCP server in the settings with:

   • Name: horologic-mcp
   • Command: node /absolute/path/to/horologic-mcp/dist/index.js

   Restart your AI assistant. The Horologic MCP tools will appear automatically.

Using with Claude

After setting up Horologic MCP, you can ask Claude questions like:

• “What time is it right now in Tokyo?”
• “Can you convert 3:00 PM New York time to London time?”
• “What’s the current time in Sydney, Australia?”
• “If it’s 9:00 AM in Berlin, what time is it in San Francisco?”

How It Works

┌─────────────┐     ┌───────────────┐     ┌─────────────┐
│             │     │               │     │             │
│   Claude    │◄────┤ Horologic MCP │◄────┤  Time API   │
│  Assistant  │     │    Server     │     │             │
│             │     │               │     │             │
└─────────────┘     └───────────────┘     └─────────────┘
      ▲                                          ▲
      │                                          │
      │                                          │
      │                                          │
      ▼                                          │
┌─────────────┐                                  │
│             │                                  │
│    User     │──────────────────────────────────┘
│             │       (Timezone queries)
└─────────────┘

Documentation

• Full API & Integration Guide
• Official MCP Specification
• Python Reference Server

License

This project is licensed under the MIT License.
© Yoda Digital. All rights reserved.