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

internal/mcp: progress notifications

Browse source 
Change-Id: I3dad9326a88c14d08d62395f603862f71f887a75
Reviewed-on: https://go-review.googlesource.com/c/tools/+/671475
TryBot-Bypass: Jonathan Amsterdam <jba@google.com>
Reviewed-by: Robert Findley <rfindley@google.com>
This commit is contained in:
Jonathan Amsterdam 2025-05-09 10:28:43 -04:00
commit d7848c9e90
1 changed files with 19 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

21
design/design.md
View file

@ -437,7 +437,24 @@ The server observes a client cancellation as cancelled context.
### Progress handling
<!-- TODO: a brief section discussing how progress is handled. -->
A caller can request progress notifications by setting the `ProgressToken` field on any request.
```go
type ProgressToken any
type XXXParams struct { // where XXX is each type of call
...
ProgressToken ProgressToken
}
```
Handlers can notify their peer about progress by calling the `NotifyProgress`
method. The notification is only sent if the peer requested it.
```go
func (*ClientSession) NotifyProgress(context.Context, *ProgressNotification)
func (*ServerSession) NotifyProgress(context.Context, *ProgressNotification)
```
We don't support progress notifications for `Client.ListRoots`, because we expect
that operation to be instantaneous relative to network latency.
### Ping / Keepalive
@ -488,7 +505,7 @@ To perform sampling, a server calls `CreateMessage`.
```
type ClientOptions struct {
...
CreateMessageHandler func(context.Context, *CreateMessageParams) (*CreateMessageResult, error)
CreateMessageHandler func(context.Context, *ClientSession, *CreateMessageParams) (*CreateMessageResult, error)
}
func (*Server) CreateMessage(context.Context, *CreateMessageParams) (*CreateMessageResult, error)