# 🦫 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 git@github.com:IBM/mcp-context-forge.git
cd mcp-servers/go/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
git clone git@github.com:IBM/mcp-context-forge.git
go install mcp-servers/go/fast-time-server
```
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
```
