2ce44d45e9Expose the jsonrpc.Error type to allow access to underlying JSON-RPC error codes. Also, expose common JSON-RPC error codes in the jsonrpc package, and MCP error codes in the mcp package. Also, implement support for the MCP URL elicitation required error (-32042), enabling servers to request out-of-band user authorization and clients to automatically handle these requests with retry logic. Server-side: - Add CodeURLElicitationRequired constant - Add URLElicitationRequiredError() constructor. Client-side: - Add urlElicitationMiddleware to intercept URLElicitationRequired errors and retry calls. - Update callElicitationCompleteHandler to signal waiting operations. - Fix capability advertisement to support both form and URL modes. Fixes #452 Fixes #623
56 lines
1.9 KiB
Go
56 lines
1.9 KiB
Go
// Copyright 2025 The Go MCP SDK Authors. All rights reserved.
|
|
// Use of this source code is governed by an MIT-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
// Package jsonrpc exposes part of a JSON-RPC v2 implementation
|
|
// for use by mcp transport authors.
|
|
package jsonrpc
|
|
|
|
import "github.com/modelcontextprotocol/go-sdk/internal/jsonrpc2"
|
|
|
|
type (
|
|
// ID is a JSON-RPC request ID.
|
|
ID = jsonrpc2.ID
|
|
// Message is a JSON-RPC message.
|
|
Message = jsonrpc2.Message
|
|
// Request is a JSON-RPC request.
|
|
Request = jsonrpc2.Request
|
|
// Response is a JSON-RPC response.
|
|
Response = jsonrpc2.Response
|
|
// Error is a structured error in a JSON-RPC response.
|
|
Error = jsonrpc2.WireError
|
|
)
|
|
|
|
// MakeID coerces the given Go value to an ID. The value should be the
|
|
// default JSON marshaling of a Request identifier: nil, float64, or string.
|
|
//
|
|
// Returns an error if the value type was not a valid Request ID type.
|
|
func MakeID(v any) (ID, error) {
|
|
return jsonrpc2.MakeID(v)
|
|
}
|
|
|
|
// EncodeMessage serializes a JSON-RPC message to its wire format.
|
|
func EncodeMessage(msg Message) ([]byte, error) {
|
|
return jsonrpc2.EncodeMessage(msg)
|
|
}
|
|
|
|
// DecodeMessage deserializes JSON-RPC wire format data into a Message.
|
|
// It returns either a Request or Response based on the message content.
|
|
func DecodeMessage(data []byte) (Message, error) {
|
|
return jsonrpc2.DecodeMessage(data)
|
|
}
|
|
|
|
// Standard JSON-RPC 2.0 error codes.
|
|
// See https://www.jsonrpc.org/specification#error_object
|
|
const (
|
|
// CodeParseError indicates invalid JSON was received by the server.
|
|
CodeParseError = -32700
|
|
// CodeInvalidRequest indicates the JSON sent is not a valid Request object.
|
|
CodeInvalidRequest = -32600
|
|
// CodeMethodNotFound indicates the method does not exist or is not available.
|
|
CodeMethodNotFound = -32601
|
|
// CodeInvalidParams indicates invalid method parameter(s).
|
|
CodeInvalidParams = -32602
|
|
// CodeInternalError indicates an internal JSON-RPC error.
|
|
CodeInternalError = -32603
|
|
)
|