mcp-fast-time-server-go

# 🦫 Fast Time Server > Author: Mihai Criveti > A minimal Go service that streams or returns the current UTC time over **stdio**, **HTTP/JSON-RPC**, or **Server‑Sent Events (SSE)**. []() []() --- ## Features - Three transports: `stdio`, `http` (JSON‑RPC 2.0), and `sse` - Single static binary (~2 MiB) - Build-time version & date via `main.appVersion`, `main.buildDate` - Cross-platform builds via `make cross` - Dockerfile for lightweight container - Linting (`golangci-lint`, `staticcheck`) and pre-commit support - Unit tests with HTML coverage & Go benchmarks - **Load testing support** using `hey` ## Quick Start ```bash git clone https://github.com/yourorg/fast-time-server.git cd fast-time-server # Build & run over stdio make run # HTTP JSON‑RPC on port 8080 make run-http # SSE endpoint on port 8080 make run-sse ``` ## Installation **Requires Go 1.23+.** ```bash go install github.com/yourorg/fast-time-server@latest ``` Also available as releases. ## CLI Flags | Flag | Default | Description | | ----------------- | --------- | --------------------------------------- | | `-transport` | `stdio` | Options: `stdio`, `http`, `sse`, `dual` | | `-addr`/`-listen` | `0.0.0.0` | Bind address for HTTP/SSE | | `-port` | `8080` | Port for HTTP/SSE/dual | | `-auth-token` | *(empty)* | Bearer token for SSE authentication | ## API Reference ### HTTP (JSON‑RPC 2.0) **POST** `/http` Request: ```json {"jsonrpc":"2.0","method":"Time.Now","id":1} ``` Response: ```json {"jsonrpc":"2.0","result":"2025-06-21T12:34:56Z","id":1} ``` ### SSE **GET** `/sse` (optional header: `Authorization: Bearer <token>`) Outputs UTC timestamps every second: ``` data: 2025-06-21T12:34:56Z ``` ## Load Testing Install the popular HTTP load tester **hey**: ```bash brew install hey # macOS wget https://hey-release... # Linux prebuilt binary ``` Run a quick load test: ```bash # 500 requests total, 50 concurrent, HTTP transport hey -n 500 -c 50 http://localhost:8080/http ``` Generate detailed CSV output for analysis: ```bash hey -n 1000 -c 100 -o csv http://localhost:8080/http > results.csv ``` ## Docker ```bash make docker-build make docker-run # HTTP mode ``` ## Cross‑Compilation ```bash make cross ``` Binaries appear under `dist/fast-time-server-<os>-<arch>`. ## Development | Task | Command | | -------------------- | --------------------------- | | Format & tidy | `make fmt tidy` | | Lint & vet | `make lint staticcheck vet` | | Run pre‑commit hooks | `make pre-commit` | ## Testing & Benchmarking ```bash make test # Unit tests (race detection) make coverage # HTML coverage report make bench # Go benchmarks ``` ## License [Apache 2.0](LICENSE)