mirror of https://github.com/jimeh/go-mcp-time.git synced 2025-12-21 21:16:43 +00:00

No description

Find a file

Jim Myhrberg 658fe26eba docs: add AGENTS.md for project guidance and development instructions (#14 )		2025-10-09 19:18:45 +01:00
.cursor/rules	docs: add AGENTS.md for project guidance and development instructions (#14 )	2025-10-09 19:18:45 +01:00
.github	docs: add AGENTS.md for project guidance and development instructions (#14 )	2025-10-09 19:18:45 +01:00
server	The task is complete. All instances of `jimeh/go-time-mcp` have been successfully replaced with `jimeh/go-mcp-time`. (#8 )	2025-07-20 01:54:56 +01:00
types	feat: add comprehensive unit tests and development workflow (#3 )	2025-07-19 23:42:34 +01:00
.gitignore	ci(release): add goreleaser and container image publishing (#9 )	2025-07-20 14:28:30 +01:00
.golangci.yml	feat: add GitHub Actions CI workflow and release automation (#6 )	2025-07-20 01:49:17 +01:00
.goreleaser.yaml	fix(ci/release): fix goreleaser config and Dockerfile.release (#10 )	2025-07-20 14:43:31 +01:00
AGENTS.md	docs: add AGENTS.md for project guidance and development instructions (#14 )	2025-10-09 19:18:45 +01:00
CHANGELOG.md	chore(main): release 0.0.2 (#11 )	2025-07-20 14:44:32 +01:00
CLAUDE.md	docs: add AGENTS.md for project guidance and development instructions (#14 )	2025-10-09 19:18:45 +01:00
Dockerfile.release	fix(ci/release): fix goreleaser config and Dockerfile.release (#10 )	2025-07-20 14:43:31 +01:00
go.mod	fix(deps/go.mod): use correct module name to match repo URL (#4 )	2025-07-20 00:27:19 +01:00
go.sum	feat: add comprehensive unit tests and development workflow (#3 )	2025-07-19 23:42:34 +01:00
LICENSE	docs(readme): add basic readme and MIT license (#5 )	2025-07-20 00:43:48 +01:00
main.go	ci(release): add goreleaser and container image publishing (#9 )	2025-07-20 14:28:30 +01:00
Makefile	feat: add GitHub Actions CI workflow and release automation (#6 )	2025-07-20 01:49:17 +01:00
README.md	docs: add AGENTS.md for project guidance and development instructions (#14 )	2025-10-09 19:18:45 +01:00

README.md

go-mcp-time

A Model Context Protocol (MCP) server for time operations.

Description

go-mcp-time is a Model Context Protocol (MCP) server that provides time-related operations for AI assistants and other MCP clients. It offers functionality for getting current time in different timezones and converting time between timezones.

The server implements the MCP specification, allowing AI assistants to query time information across various IANA timezone names. It provides a simple and flexible solution for time operations within the MCP ecosystem.

Installation

go install github.com/jimeh/go-mcp-time@latest

Usage

Using Go Binary

Start the MCP server using the command line:

# Use system default timezone
go-mcp-time

# Override local timezone (accepts IANA timezone names)
go-mcp-time -local-timezone="America/New_York"
go-mcp-time -local-timezone="Europe/London"
go-mcp-time -local-timezone="Asia/Tokyo"

Using Docker

A container image is available at ghcr.io/jimeh/go-mcp-time. The image is built from scratch and includes timezone data for IANA timezone support. When running via Docker, the server defaults to UTC timezone.

# Use default UTC timezone
docker run --rm ghcr.io/jimeh/go-mcp-time

# Set timezone using TZ environment variable
docker run --rm -e TZ="America/New_York" ghcr.io/jimeh/go-mcp-time
docker run --rm -e TZ="Europe/London" ghcr.io/jimeh/go-mcp-time

# Run with specific tag/version
docker run --rm -e TZ="Asia/Tokyo" ghcr.io/jimeh/go-mcp-time:v0.0.2

The container exposes the MCP server on stdout/stdin for communication with MCP clients.

Command Line Options

-local-timezone: Override the local timezone (default: system timezone or UTC)

Available Tools

The server provides the following MCP tools:

get_current_time: Get current time in a specific timezone
convert_time: Convert time between different timezones

Documentation

Full documentation is available at pkg.go.dev.

License

MIT License