This repository was archived by the owner on Jan 21, 2026. It is now read-only.
Repository navigation
v0.3.0
This release introduces significant improvements in API consistency and modernizes the codebase by adopting Go 1.23's iterator pattern. Key changes include restructured parameter naming conventions, simplified package organization, enhanced transport interfaces, and improved SSE handling through the integration of go-sse library. The adoption of iterators for handling sessions, messages, and streaming operations provides a more efficient and safer alternative to channels for sequential data processing.
Added
Sessioninterface for handling session onServerTransportinterfaces.ProgressReporterfunction type for reporting progress in server primitive operationsResourceSubscriptionHandlerinterface for handling resource subscriptions.
Changed
- Refactored parameter naming convention for
Clientrequest methods to improve consistency between method names and their parameters. Previously, parameter names likePromptsListParamsandPromptsGetParamsused noun-verb style while methods used verb-noun style. Now, parameter names follow the same verb-noun pattern as their corresponding methods (e.g.,ListPromptsParamsandGetPromptParams). - Refactored the result name of the request calls, either in
ClientorServerinterfaces. This is done to improve consistency between method names and their results. For example,ListPromptsnow returnsListPromptsResultinstead ofPromptList. - Use structured parameter types (such as
ListPromptsParamsorGetPromptParams) inClientmethod signatures when making server requests, rather than using individual parameters. For example, instead of passing separatecursorandprogressTokenparameters toListPrompts, ornameandargumentstoGetPrompt, use a dedicated parameter struct. - Utilize
go-sseto handleSSEClientby @tmaxmax. - Utilize
go-sse'sSessionto sent the event messages fromSSEServer. - Moved
mcppackage frompkg/mcpto root folder andpkg/serverspackage toserverspackage to simplify import paths. Thepkgdirectory added unnecessary nesting and noise in import paths (e.g., fromgithub.com/MegaGrindStone/go-mcp/pkg/mcptogithub.com/MegaGrindStone/go-mcp, and fromgithub.com/MegaGrindStone/go-mcp/pkg/serverstogithub.com/MegaGrindStone/go-mcp/servers). - Split
Transportinterface intoServerTransportandClientTransportinterfaces.ClientTransportdoesn't need session-based messages asClientwould just use oneSessionin its lifecycle. - Use iterator pattern for sessions in
ServerTransportand messages inClientTransport. - Use iterator pattern for streaming logs in
LogHandler. - Use iterator pattern for all the updaters.
- Use
io.ReadCloserandio.WriteCloserforStdIOtransport. - Adjust
everythingserver for current interfaces. - Adjust
filesystemserver for current interfaces.
Removed
pkg/mcppackage (moved to root for cleaner imports).pkg/serverspackage (moved toserversfor cleaner imports).Transportinterface (replaced byServerTransportandClientTransport)ProgressReporterinterface (replaced with function type for simpler progress reporting)ResourceSubscribedUpdaterinterface (replaced withResourceSubscriptionHandler)