docs:AAdd GoDoc comments to exported functions.

Author: lianghui

mcp/utils.go

@@ -604,76 +604,95 @@ func ParseArgument(request CallToolRequest, key string, defaultVal any) any {
 	}
 }
 
+// ParseBoolean extracts and converts a boolean parameter from a CallToolRequest.
+// If the key is not found in the Arguments map, the defaultValue is returned.
+// The function uses cast.ToBool for conversion which handles various string representations
+// such as "true", "yes", "1", etc.
 func ParseBoolean(request CallToolRequest, key string, defaultValue bool) bool {
 	v := ParseArgument(request, key, defaultValue)
 	return cast.ToBool(v)
 }
 
+// ParseInt64 extracts and converts an int64 parameter from a CallToolRequest.
+// If the key is not found in the Arguments map, the defaultValue is returned.
 func ParseInt64(request CallToolRequest, key string, defaultValue int64) int64 {
 	v := ParseArgument(request, key, defaultValue)
 	return cast.ToInt64(v)
 }
 
+// ParseInt32 extracts and converts an int32 parameter from a CallToolRequest.
 func ParseInt32(request CallToolRequest, key string, defaultValue int32) int32 {
 	v := ParseArgument(request, key, defaultValue)
 	return cast.ToInt32(v)
 }
 
+// ParseInt16 extracts and converts an int16 parameter from a CallToolRequest.
 func ParseInt16(request CallToolRequest, key string, defaultValue int16) int16 {
 	v := ParseArgument(request, key, defaultValue)
 	return cast.ToInt16(v)
 }
 
+// ParseInt8 extracts and converts an int8 parameter from a CallToolRequest.
 func ParseInt8(request CallToolRequest, key string, defaultValue int8) int8 {
 	v := ParseArgument(request, key, defaultValue)
 	return cast.ToInt8(v)
 }
 
+// ParseInt extracts and converts an int parameter from a CallToolRequest.
 func ParseInt(request CallToolRequest, key string, defaultValue int) int {
 	v := ParseArgument(request, key, defaultValue)
 	return cast.ToInt(v)
 }
 
+// ParseUInt extracts and converts an uint parameter from a CallToolRequest.
 func ParseUInt(request CallToolRequest, key string, defaultValue uint) uint {
 	v := ParseArgument(request, key, defaultValue)
 	return cast.ToUint(v)
 }
 
+// ParseUInt64 extracts and converts an uint64 parameter from a CallToolRequest.
 func ParseUInt64(request CallToolRequest, key string, defaultValue uint64) uint64 {
 	v := ParseArgument(request, key, defaultValue)
 	return cast.ToUint64(v)
 }
 
+// ParseUInt32 extracts and converts an uint32 parameter from a CallToolRequest.
 func ParseUInt32(request CallToolRequest, key string, defaultValue uint32) uint32 {
 	v := ParseArgument(request, key, defaultValue)
 	return cast.ToUint32(v)
 }
 
+// ParseUInt16 extracts and converts an uint16 parameter from a CallToolRequest.
 func ParseUInt16(request CallToolRequest, key string, defaultValue uint16) uint16 {
 	v := ParseArgument(request, key, defaultValue)
 	return cast.ToUint16(v)
 }
 
+// ParseUInt8 extracts and converts an uint8 parameter from a CallToolRequest.
 func ParseUInt8(request CallToolRequest, key string, defaultValue uint8) uint8 {
 	v := ParseArgument(request, key, defaultValue)
 	return cast.ToUint8(v)
 }
 
+// ParseFloat32 extracts and converts a float32 parameter from a CallToolRequest.
 func ParseFloat32(request CallToolRequest, key string, defaultValue float32) float32 {
 	v := ParseArgument(request, key, defaultValue)
 	return cast.ToFloat32(v)
 }
 
+// ParseFloat64 extracts and converts a float64 parameter from a CallToolRequest.
 func ParseFloat64(request CallToolRequest, key string, defaultValue float64) float64 {
 	v := ParseArgument(request, key, defaultValue)
 	return cast.ToFloat64(v)
 }
 
+// ParseString extracts and converts a string parameter from a CallToolRequest.
 func ParseString(request CallToolRequest, key string, defaultValue string) string {
 	v := ParseArgument(request, key, defaultValue)
 	return cast.ToString(v)
 }
 
+// ParseStringMap extracts and converts a string map parameter from a CallToolRequest.
 func ParseStringMap(request CallToolRequest, key string, defaultValue map[string]any) map[string]any {
 	v := ParseArgument(request, key, defaultValue)
 	return cast.ToStringMap(v)