Watch

History

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
adam jones fe6d3cf74a chore: update licensing to Apache 2.0 for new contributions (#750 ) As part of MCP joining the Linux Foundation, this PR updates licensing to Apache 2.0 for new contributions while grandfathering existing MIT code. See modelcontextprotocol/modelcontextprotocol#1994 --------- Co-authored-by: Maciek Kisiel <mkisiel@google.com>		2026-01-28 09:17:41 +01:00
..
client	many: minor cosmetic changes (#529 )	2025-09-25 16:06:24 -04:00
server	many: minor cosmetic changes (#529 )	2025-09-25 16:06:24 -04:00
doc.go	internal/readme: use go:generate rather than Make	2025-09-11 10:38:07 -04:00
README.src.md	chore: update licensing to Apache 2.0 for new contributions (#750 )	2026-01-28 09:17:41 +01:00

README.src.md

MCP Go SDK

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

Package / Feature documentation

The SDK consists of several importable packages:

The github.com/modelcontextprotocol/go-sdk/mcp package defines the primary APIs for constructing and using MCP clients and servers.
The github.com/modelcontextprotocol/go-sdk/jsonrpc package is for users implementing their own transports.
The github.com/modelcontextprotocol/go-sdk/auth package provides some primitives for supporting OAuth.
The github.com/modelcontextprotocol/go-sdk/oauthex package provides extensions to the OAuth protocol, such as ProtectedResourceMetadata.

The SDK endeavors to implement the full MCP spec. The docs/ directory contains feature documentation, mapping the MCP spec to the packages above.

Version Compatibility

The following table shows which versions of the Go SDK support which versions of the MCP specification:

SDK Version	Latest MCP Spec	All Supported MCP Specs
v1.2.0+	2025-06-18	2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05
v1.0.0 - v1.1.0	2025-06-18	2025-06-18, 2025-03-26, 2024-11-05

Getting started

To get started creating an MCP server, create an mcp.Server instance, add features to it, and then run it over an mcp.Transport. For example, this server adds a single simple tool, and then connects it to clients over stdin/stdout:

%include server/server.go -

To communicate with that server, create an mcp.Client and connect it to the corresponding server, by running the server command and communicating over its stdin/stdout:

%include client/client.go -

The examples/ directory contains more example clients and servers.

Contributing

We welcome contributions to the SDK! Please see CONTRIBUTING.md for details of how to contribute.

Acknowledgements / Alternatives

Several third party Go MCP SDKs inspired the development and design of this official SDK, and continue to be viable alternatives, notably mcp-go, originally 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 Apache 2.0 for new contributions, with existing code under MIT - see the LICENSE file for details.