Utility

Provides datetime utilities, time-difference calculations, and Read.AI download tooling with a server health check.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "danfmaia-util-mcp": {
      "command": "/home/danfmaia/.local/bin/uv",
      "args": [
        "--directory",
        "/home/danfmaia/_repos/_mcp/util-mcp",
        "run",
        "util_server.py"
      ],
      "env": {
        "READ_AI_API_KEY": "YOUR_READ_AI_API_KEY"
      }
    }
  }
}

You run a focused, utility-based MCP server that exposes date/time tools and a Read.AI downloader while offering a simple server-status check. It is designed to be easy to start, test, and use with an MCP client to perform time calculations, fetch current datetimes in multiple time zones, and verify the health of your utility tools.

How to use

You interact with this server through an MCP client or your own automation that can request tool functions. The core capabilities you can leverage are: getting the current date and time in various time zones in several formats, calculating time differences between dates (or from a date to now), downloading meeting transcripts and summaries from the Read.AI platform (requires an API key), and checking the overall status of all utility tools.

Practical usage patterns include: obtaining the current time in a specific zone and format for logging or user-facing displays, computing elapsed durations for scheduling or reminders, and triggering a local health check to ensure all utility tools are ready and responsive. If you need to access the advanced Read.AI downloader, ensure you have the required API key configured in your environment before attempting the operation.

How to install

cd /home/danfmaia/_repos/_mcp/util-mcp
uv install

Configuration and usage notes

The server is designed to run as a local MCP process. You can launch it via the Cursor-based MCP orchestration or run it directly for testing.

uv run util_server.py

Tools and environment

The following tools are exposed by the Utility MCP Server. Each tool provides a specific action you can invoke from your MCP client.

get_current_datetime: Retrieve the current date and time in a specified timezone with multiple formatting options.
calculate_time_difference: Compute the difference between two dates or from a date to now, with a detailed breakdown by days, hours, minutes, and seconds.
download_meeting_data: Download transcripts and summaries from Read.AI. Requires a valid API key and appropriate permissions.
util_server_status: Check the configuration and availability of all utility tools.

Testing

For quick validation, you can run unit-style tests or sample calls if you have test scripts like test_datetime.py. Use the standard Python environment to execute tests when you have it prepared.

Available tools

get_current_datetime

Get current date/time in any timezone with multiple format options (ISO, readable, timestamp, custom).

calculate_time_difference

Calculate time differences between two dates or from a date to now with a detailed breakdown (days, hours, minutes, seconds) and multiple input formats.

download_meeting_data

Download meeting transcripts and summaries from Read.AI platform. Requires READ_AI_API_KEY environment variable.

util_server_status

Check configuration and availability of all utility tools.