Merge branch 'modelcontextprotocol:main' into add-sequentialthinking-example

Author: nsega

README.md

@@ -1,5 +1,11 @@
 <!-- Autogenerated by weave; DO NOT EDIT -->
-# MCP Go SDK
+# MCP Go SDK v0.2.0
+
+***BREAKING CHANGES***
+
+This version contains breaking changes.
+See the [release notes](
+https://github.com/modelcontextprotocol/go-sdk/releases/tag/v0.2.0) for details.
 
 [![PkgGoDev](https://pkg.go.dev/badge/github.com/modelcontextprotocol/go-sdk)](https://pkg.go.dev/github.com/modelcontextprotocol/go-sdk)
 
@@ -26,7 +32,7 @@ open-ended discussion. See CONTRIBUTING.md for details.
 
 ## Package documentation
 
-The SDK consists of two importable packages:
+The SDK consists of three importable packages:
 
 - The
   [`github.com/modelcontextprotocol/go-sdk/mcp`](https://pkg.go.dev/github.com/modelcontextprotocol/go-sdk/mcp)
@@ -36,6 +42,10 @@ The SDK consists of two importable packages:
   [`github.com/modelcontextprotocol/go-sdk/jsonschema`](https://pkg.go.dev/github.com/modelcontextprotocol/go-sdk/jsonschema)
   package provides an implementation of [JSON
   Schema](https://json-schema.org/), used for MCP tool input and output schema.
+- The
+  [`github.com/modelcontextprotocol/jsonrpc`](https://pkg.go.dev/github.com/modelcontextprotocol/go-sdk/jsonschema) package is for users implementing
+  their own transports.
+   
 
 ## Example
 
@@ -57,7 +67,7 @@ func main() {
 	ctx := context.Background()
 
 	// Create a new client, with no features.
-	client := mcp.NewClient("mcp-client", "v1.0.0", nil)
+	client := mcp.NewClient(&mcp.Implementation{Name: "mcp-client", Version: "v1.0.0"}, nil)
 
 	// Connect to a server over stdin/stdout
 	transport := mcp.NewCommandTransport(exec.Command("myserver"))
@@ -99,7 +109,7 @@ import (
 )
 
 type HiParams struct {
-	Name string `json:"name"`
+	Name string `json:"name", mcp:"the name of the person to greet"`
 }
 
 func SayHi(ctx context.Context, cc *mcp.ServerSession, params *mcp.CallToolParamsFor[HiParams]) (*mcp.CallToolResultFor[any], error) {
@@ -110,12 +120,9 @@ func SayHi(ctx context.Context, cc *mcp.ServerSession, params *mcp.CallToolParam
 
 func main() {
 	// Create a server with a single tool.
-	server := mcp.NewServer("greeter", "v1.0.0", nil)
-	server.AddTools(
-		mcp.NewServerTool("greet", "say hi", SayHi, mcp.Input(
-			mcp.Property("name", mcp.Description("the name of the person to greet")),
-		)),
-	)
+	server := mcp.NewServer(&mcp.Implementation{Name: "greeter", Version: "v1.0.0"}, nil)
+
+	mcp.AddTool(server, &mcp.Tool{Name: "greet", Description: "say hi"}, SayHi)
 	// Run the server over stdin/stdout, until the client disconnects
 	if err := server.Run(context.Background(), mcp.NewStdioTransport()); err != nil {
 		log.Fatal(err)

design/design.md

@@ -40,7 +40,7 @@ func main() {
 
 	// Create the MCP Server instance and assign the handler.
 	// No server running, just showing the configuration.
-	_ = mcp.NewServer("myServer", "v1.0.0", &mcp.ServerOptions{
+	_ = mcp.NewServer(&mcp.Implementation{Name: "server"}, &mcp.ServerOptions{
 		CompletionHandler: myCompletionHandler,
 	})
 

examples/completion/main.go

@@ -19,7 +19,7 @@ import (
 var httpAddr = flag.String("http", "", "if set, use streamable HTTP at this address, instead of stdin/stdout")
 
 type HiArgs struct {
-	Name string `json:"name"`
+	Name string `json:"name" mcp:"the name to say hi to"`
 }
 
 func SayHi(ctx context.Context, ss *mcp.ServerSession, params *mcp.CallToolParamsFor[HiArgs]) (*mcp.CallToolResultFor[struct{}], error) {
@@ -42,22 +42,14 @@ func PromptHi(ctx context.Context, ss *mcp.ServerSession, params *mcp.GetPromptP
 func main() {
 	flag.Parse()
 
-	server := mcp.NewServer("greeter", "v0.0.1", nil)
-	server.AddTools(mcp.NewServerTool("greet", "say hi", SayHi, mcp.Input(
-		mcp.Property("name", mcp.Description("the name to say hi to")),
-	)))
-	server.AddPrompts(&mcp.ServerPrompt{
-		Prompt:  &mcp.Prompt{Name: "greet"},
-		Handler: PromptHi,
-	})
-	server.AddResources(&mcp.ServerResource{
-		Resource: &mcp.Resource{
-			Name:     "info",
-			MIMEType: "text/plain",
-			URI:      "embedded:info",
-		},
-		Handler: handleEmbeddedResource,
-	})
+	server := mcp.NewServer(&mcp.Implementation{Name: "greeter"}, nil)
+	mcp.AddTool(server, &mcp.Tool{Name: "greet", Description: "say hi"}, SayHi)
+	server.AddPrompt(&mcp.Prompt{Name: "greet"}, PromptHi)
+	server.AddResource(&mcp.Resource{
+		Name:     "info",
+		MIMEType: "text/plain",
+		URI:      "embedded:info",
+	}, handleEmbeddedResource)
 
 	if *httpAddr != "" {
 		handler := mcp.NewStreamableHTTPHandler(func(*http.Request) *mcp.Server {