Skip to content

yoda-digital/horologic-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Horologic MCP Logo

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

License

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

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors