Repository navigation
Releases
Releases · StevenCyb/GoMCP
v0.3.0: stdio transport, gomcp init and gomcp call
New
- gomcp init : scaffolds a new project with go.mod, api.go (a hello tool), .gitignore and a README. It runs go get and go mod tidy unless you pass --no-get. Use --module to set the module path.
- gomcp call [tool] [json]: lists or calls tools from the terminal, with no client needed. It supports --json, --root, --tags and --dotenv. Each call starts its own server, so state is not kept between calls.
- examples/: the old example/ is now examples/features. New: hello, files, todo and fetch, each its own module with tests and a README.
Docs
- New "Why GoMCP" section, with "See It In 5 Seconds" first.
- README covers transports (local or remote) and the new commands.
- SECURITY.md covers stdio.
v0.2.0: run locally over stdio
- Built binaries take
--stdio(orGOMCP_TRANSPORT=stdio); HTTP stays the default Server.ServeStdioinpkg/mcpfor using it by hand- README: a "Local or remote" section with client config and the differences
Over stdio
- No authentication and no scope checks: the caller is the process that started the server
- Logs go to stderr; stdout carries protocol messages only
gomcp watchdoes not support stdio- Relative icon URLs are left out (use absolute or
data:URLs) - Tools, resources, prompts, elicitation, sampling, roots, tasks and
subscriptions/listenwork as over HTTP
Nothing changes for existing HTTP users.
v0.1.1
Hardening, Windows support and more tests. No new features and no breaking changes to annotations.
Fixed
- Windows:
gomcp serveandwatchnow work (the built server had no.exe) BindURIrejects numbers that do not fit the field (300into anint8)ctx.ElicitDoneno longer reports completion for unknown or expired ids; select onctx.Done()too
Changed (safer defaults)
- The server listens on
127.0.0.1:8080unlessGOMCP_ADDRor--addris set @MCP.Cachedefaults toscope="private"
Added
WithLimitsfor tasks, open streams and URL elicitationsexample/README.md, godoc examples, CI on Linux, Windows and macOS, pre-release label for-rctags
v0.1.0
First release of GoMCP: build MCP servers in Go from annotated functions.
Write plain Go handlers, add @MCP.* comments, run gomcp serve. Implements MCP specification
2026-07-28 over Streamable HTTP: tools, resources, prompts, completion, elicitation, sampling,
roots, tasks, subscriptions/listen, bearer and OAuth auth.
Known issues, fixed in v0.2.0:
gomcp serveandwatchdo not work on Windows- the server listens on all interfaces by default
- tasks, streams and URL elicitations have no limits