Skip to content

Releases

v0.3.0: stdio transport, gomcp init and gomcp call

Choose a tag to compare

@StevenCyb StevenCyb released this 17 Nov 09:21
8454544

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

Choose a tag to compare

@StevenCyb StevenCyb released this 16 Nov 07:57
a5dad6d
  • Built binaries take --stdio (or GOMCP_TRANSPORT=stdio); HTTP stays the default
  • Server.ServeStdio in pkg/mcp for 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 watch does not support stdio
  • Relative icon URLs are left out (use absolute or data: URLs)
  • Tools, resources, prompts, elicitation, sampling, roots, tasks and subscriptions/listen work as over HTTP

Nothing changes for existing HTTP users.

v0.1.1

Choose a tag to compare

@StevenCyb StevenCyb released this 16 Nov 05:42
2ed0105

Hardening, Windows support and more tests. No new features and no breaking changes to annotations.

Fixed

  • Windows: gomcp serve and watch now work (the built server had no .exe)
  • BindURI rejects numbers that do not fit the field (300 into an int8)
  • ctx.ElicitDone no longer reports completion for unknown or expired ids; select on ctx.Done() too

Changed (safer defaults)

  • The server listens on 127.0.0.1:8080 unless GOMCP_ADDR or --addr is set
  • @MCP.Cache defaults to scope="private"

Added

  • WithLimits for tasks, open streams and URL elicitations
  • example/README.md, godoc examples, CI on Linux, Windows and macOS, pre-release label for -rc tags

v0.1.0

Choose a tag to compare

@StevenCyb StevenCyb released this 14 Nov 20:15
175b4e2

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 serve and watch do not work on Windows
  • the server listens on all interfaces by default
  • tasks, streams and URL elicitations have no limits