mcpField
M
mcp-epochs

mcp-epochs

Local
github.com/daedalusOther0Updated 27w ago
Repository

About mcp-epochs

mcp-epochs is an MCP server for LLMs that returns the current Unix time in seconds and milliseconds, plus UTC ISO 8601 time. It provides a single tool over STDIO.

Key features

  1. 01Current Unix time in seconds
  2. 02Current Unix time in milliseconds
  3. 03UTC time in ISO 8601 format

Use cases

  1. 01Providing an LLM with the current timestamp
  2. 02Getting UTC time in a structured response

MCP support

Exposes the `get_unix_time` tool to MCP clients over STDIO. The tool returns Unix timestamps in seconds and milliseconds, as well as UTC ISO 8601 time.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "daedalus-mcp-epochs": {
      "command": "uvx",
      "args": [
        "mcp-epochs"
      ]
    }
  }
}
Run commanduvx mcp-epochs

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-epochs0.1.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

mcp-epochs

mcp-name: io.github.daedalus/mcp-epochs

MCP tool that provides current Unix timestamp (epochs) to LLMs.

PyPI Python Coverage Ruff

Install

pip install mcp-epochs

Usage

mcp-epochs

This runs the MCP server with STDIO transport. The server provides a get_unix_time tool.

MCP Configuration

{
  "mcpServers": {
    "mcp-epochs": {
      "command": "mcp-epochs"
    }
  }
}

Development

git clone https://github.com/daedalus/mcp-epochs.git
cd mcp-epochs
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

API

get_unix_time()

Returns the current Unix timestamp as a dictionary with the following keys:

  • unix_time (int): Current Unix timestamp in seconds since epoch.
  • unix_time_ms (int): Current Unix timestamp in milliseconds since epoch.
  • iso8601 (str): Current UTC time in ISO 8601 format (e.g., "2026-03-26T21:30:00Z").
run_server()

Starts the MCP server using STDIO transport for local desktop MCP clients.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.