modelcontextprotocol/go-sdk
Watch
1
0
Fork
You've already forked go-sdk
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
go-sdk/internal/readme
History
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Jonathan Amsterdam 3da831b0c9
 mcp: move to 2025-06-18 schema (#8) 
* mcp: move to 2025-06-18 schema

Add types and fields for the latest MCP schema.

The main challenge here was dealing with the presence of _meta fields
on many types, like Tool, Prompt and Resource.

- Distinguish between the _meta field of a request's params, which
  includes a progress token, from the _meta field on other types,
  which is simply a map.

- Redefine GetMeta to return a pointer to the map. We wanted to avoid
  that, but I don't see a clean way to do so. An alternative would be
  to have GetMeta return a map, and SetMeta to set it.

- Provide GetProgressToken for requests only (not notifications or other
  types).

- Still to do: deal with the meta and annotation fields of ContentBlock,
  which are currently duplicated for Resource and ResourceContents.

* Meta and progress token redesign
2025-06-25 09:48:33 -04:00
..
client internal/mcp: update CONTRIBUTING.md and README.md for the official SDK 2025-06-20 13:30:05 -07:00
server mcp: move to 2025-06-18 schema (#8) 2025-06-25 09:48:33 -04:00
build.sh mcp, internal/readme: fix go generate (#6) 2025-06-23 15:46:53 -04:00
Makefile internal/mcp: construct README with weave 2025-05-21 16:21:26 -07:00
README.src.md README: remove toc, update target date 2025-06-23 17:58:00 +00:00

README.src.md

MCP Go SDK

PkgGoDev

This repository contains an implementation of the official Go software development kit (SDK) for the Model Context Protocol (MCP).

WARNING: The SDK is currently unstable and subject to breaking changes. Please test it out and file bug reports or API proposals. The TODO section below outlines outstanding release blockers. We aim to release a stable version of the SDK in August, 2025.

Package documentation

The SDK consists of two importable packages:

Example

In this example, an MCP client communicates with an MCP server running in a sidecar process:

%include client/client.go -

Here's an example of the corresponding server component, which communicates with its client over stdin/stdout:

%include server/server.go -

The examples/ directory contains more example clients and servers.

TODO

The following TODOs block the release of this SDK:

  • Better support for resumability in the Streamable HTTP transport: a server-side event store and client-side retry configuration.
  • OAuth support (or examples of implementing OAuth using middleware).
  • Support for the changes in the 2025-06-18 version of the MCP spec.
  • More examples and documentation.

Design

The design doc for this SDK is at design.md, which was initially reviewed at modelcontextprotocol/discussions/364.

Further design discussion should occur in GitHub issues. See CONTRIBUTING.md for details.

Acknowledgements

Several existing Go MCP SDKs inspired the development and design of this official SDK, notably mcp-go, authored by Ed Zynda. We are grateful to Ed as well as the other contributors to mcp-go, and to authors and contributors of other SDKs such as mcp-golang and go-mcp. Thanks to their work, there is a thriving ecosystem of Go MCP clients and servers.

License

This project is licensed under the MIT License - see the LICENSE file for details.