marchon/verae-mcp-timestamping-server-go
Watch
1
0
Fork
You've already forked verae-mcp-timestamping-server-go
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Go MCP timestamping server + pkg/tsnats (sibling to Python server)
12 commits 3 branches 0 tags 301 KiB
  • Go 96.6%
  • Shell 3.4%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
George Lambert e04fe6e2c4 feat: embedded NATS with VeraeTime handlers and stdio MCP 
Start in-process nats-server on VERAE_NATS_LISTEN (default 127.0.0.1:4223;
empty disables). Queue-subscribe verae.ts.request|verify|hash.report with
ledger/veraetime routing and authctx.Resolve from authorization/access_token.
Publish verae.ts.completed on core NATS only (no JetStream). Wire embed into
main alongside Streamable HTTP; stdio MCP via go-sdk StdioTransport.
2026-09-29 12:11:47 -04:00
cmd/verae-mcp-timestamping-server feat: embedded NATS with VeraeTime handlers and stdio MCP 2026-09-29 12:11:47 -04:00
docs/superpowers docs: embedded NATS, bearer require flag, host-token keeper 2026-09-29 11:49:43 -04:00
internal feat: embedded NATS with VeraeTime handlers and stdio MCP 2026-09-29 12:11:47 -04:00
pkg feat: pkg/tsnats digests-only NATS timestamp client 2026-09-29 11:52:35 -04:00
.gitignore feat: module scaffold and digest normalize/guard 2026-09-29 11:43:22 -04:00
go.mod feat: embedded NATS with VeraeTime handlers and stdio MCP 2026-09-29 12:11:47 -04:00
go.sum feat: embedded NATS with VeraeTime handlers and stdio MCP 2026-09-29 12:11:47 -04:00
README.md feat: embedded NATS with VeraeTime handlers and stdio MCP 2026-09-29 12:11:47 -04:00

README.md

verae-mcp-timestamping-server-go

standard-readme compliant

Go MCP timestamping server for Verae. Digests only; sibling to the Python server.

Implements the same tools as https://mcp.verae.ai/mcp (stamp, verify, hash_report, auth tools) using the official MCP Go SDK. Designed for shadow deploy beside Python, then cutover.

AI assistants use MCP. Bulk app workers can import pkg/tsnats for core NATS request/reply on verae.ts.* (job-complete stays ephemeral; no JetStream for those events).

Table of Contents

Install

cd verae-mcp-timestamping-server-go
go build -o bin/verae-mcp-timestamping-server ./cmd/verae-mcp-timestamping-server

Requires Go 1.26+. Design: docs/superpowers/specs/2026-09-29-go-mcp-timestamping-server-design.md.

Usage

VERAE_MCP_TRANSPORT=streamable-http \
VERAE_MCP_HOST=127.0.0.1 \
VERAE_MCP_PORT=8001 \
VERAE_NATS_LISTEN=127.0.0.1:4223 \
./bin/verae-mcp-timestamping-server

Point clients at http://127.0.0.1:8001/mcp. Global stamps use https://api.veraetime.net with auth from ~/.verae/auth.properties (or VERAE_AUTH_PROPERTIES). Embedded NATS (default 127.0.0.1:4223; set VERAE_NATS_LISTEN= empty to disable) serves verae.ts.* with the same ledger/VeraeTime routing; job-complete is core verae.ts.completed only. For stdio MCP: -transport stdio or VERAE_MCP_TRANSPORT=stdio.

Contributing

Questions: this research workspace / marchon@gmail.com. PRs coordinated in-workspace first. Protocol questions: https://github.com/modelcontextprotocol.

License

UNLICENSED © George Lambert