modelcontextprotocol/go-sdk
Watch
1
0
Fork
You've already forked go-sdk
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 2
go-sdk/internal/docs
History
Exact
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
..
client.src.md docs/client: fix the SEP-1034 and SEP-1330 links (#1252) 2026-09-14 17:20:25 +00:00
doc.go Add documentation backed by mkdocs (#883) 2026-04-09 14:25:43 +02:00
mcpgodebug.src.md mcp: preserve structured content number precision (#1239) 2026-09-16 09:22:16 +02:00
protocol.src.md oauthex: oauth discovery checks (#1220) 2026-09-02 21:07:19 +02:00
quick_start.src.md docs: quick start go get leaves the module unbuildable (#1148) 2026-08-06 16:27:46 +02:00
README.src.md Add documentation backed by mkdocs (#883) 2026-04-09 14:25:43 +02:00
rough_edges.src.md fix: do not omitempty ReadOnlyHint in ToolAnnotations (#908) 2026-05-25 15:52:15 +02:00
server.src.md docs/server: fix logging defaults and the SetLoggingLevel method name (#1251) 2026-09-15 11:44:03 +00:00
toc_test.go docs: make the protocol.md table of contents resolve (#1196) 2026-08-25 09:26:21 +02:00
troubleshooting.src.md docs: add feature and troubleshooting documentation (#463) 2025-09-16 11:13:40 -04:00

README.src.md

Overview

The SDK consists of several importable packages:

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

  1. Lifecycle (Clients, Servers, and Sessions).
  2. Transports
    1. Stdio transport
    2. Streamable transport
    3. Custom transports
  3. Authorization
  4. Security
  5. Utilities
    1. Cancellation
    2. Ping
    3. Progress

Client Features

  1. Roots
  2. Sampling
  3. Elicitation

Server Features

  1. Prompts
  2. Resources
  3. Tools
  4. Utilities
    1. Completion
    2. Logging
    3. Pagination

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.