Watch

History

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
Luca Candela 3785c500b5 mcp: preserve structured content number precision (#1239 ) CallToolResult currently decodes structuredContent through an any field, which converts JSON numbers to float64 and silently rounds integers outside the IEEE-754 safe range. This change decodes structuredContent separately with UseNumber, preserving wire numbers as json.Number while retaining the existing decoded object, array, and primitive shapes. The field documentation now describes that representation. Users who depend on the previous float64 behavior can temporarily restore it with MCPGODEBUG=structuredcontentfloat64=1. An end-to-end in-memory client/server regression covers 9007199254740993 from a low-level Server.AddTool result. Additional coverage verifies the compatibility option restores the legacy rounded float64 value. Verification: - gofmt -l . - go test ./... - go vet ./... Fixes #1236 --------- Co-authored-by: Guglielmo Colombo <guglielmoc@google.com>		2026-09-16 09:22:16 +02:00
..
images	Add documentation backed by mkdocs (#883 )	2026-04-09 14:25:43 +02:00
client.md	docs/client: fix the SEP-1034 and SEP-1330 links (#1252 )	2026-09-14 17:20:25 +00:00
CNAME	Add documentation backed by mkdocs (#883 )	2026-04-09 14:25:43 +02:00
contributing.md	Add documentation backed by mkdocs (#883 )	2026-04-09 14:25:43 +02:00
mcpgodebug.md	mcp: preserve structured content number precision (#1239 )	2026-09-16 09:22:16 +02:00
protocol.md	oauthex: oauth discovery checks (#1220 )	2026-09-02 21:07:19 +02:00
quick_start.md	docs: quick start `go get` leaves the module unbuildable (#1148 )	2026-08-06 16:27:46 +02:00
README.md	Add documentation backed by mkdocs (#883 )	2026-04-09 14:25:43 +02:00
rough_edges.md	fix: do not `omitempty` `ReadOnlyHint` in `ToolAnnotations` (#908 )	2026-05-25 15:52:15 +02:00
server.md	docs/server: fix logging defaults and the SetLoggingLevel method name (#1251 )	2026-09-15 11:44:03 +00:00
troubleshooting.md	mcp: update return meta in DiscoverResult (SEP-2575) (#1097 )	2026-07-16 16:10:12 +02:00

README.md

Overview

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.

These docs mirror the official MCP spec. Use the index below to learn how the SDK implements a particular aspect of the protocol.

Base Protocol

Client Features

Server Features

TroubleShooting

See troubleshooting.md for a troubleshooting guide.

Backwards compatibility

See mcpgodebug.md for a list of backwards incompatible behavior changes and description how they can be temporarily undone.

Rough edges

See rough_edges.md for a list of rough edges or API oversights that can't be addressed due to our compatibility promise. We'll revisit these if/when we move to a v2 of the SDK.