webdav/sync/go/pkg/mod/golang.org/x/tools@v0.34.1-0.20250610205101-c26dd3ba555e/internal/mcp - 志元云盘

File OriginalPic	EditTime	Size
design	2025-07-22 10:59:07	52.89 KB
examples	2025-07-22 10:59:07	3.76 KB
internal	2025-07-22 10:59:07	7.8 KB
jsonschema	2025-07-22 10:59:07	432.74 KB
testdata	2025-07-22 10:59:07	4.39 KB
client.go	2025-07-22 10:59:07	15.2 KB
client_list_test.go	2025-07-22 10:59:07	4.75 KB
client_test.go	2025-07-22 10:59:07	5.08 KB
cmd.go	2025-07-22 10:59:07	2.9 KB
cmd_test.go	2025-07-22 10:59:07	1.63 KB
conformance_test.go	2025-07-22 10:59:07	9.97 KB
content.go	2025-07-22 10:59:07	4.25 KB
content_test.go	2025-07-22 10:59:07	2.56 KB
CONTRIBUTING.md	2025-07-22 10:59:07	925 B
example_progress_test.go	2025-07-22 10:59:07	821 B
features.go	2025-07-22 10:59:07	3 KB
features_test.go	2025-07-22 10:59:07	2.22 KB
generate.go	2025-07-22 10:59:07	18.92 KB
logging.go	2025-07-22 10:59:07	5.17 KB
mcp.go	2025-07-22 10:59:07	2.18 KB
mcp_test.go	2025-07-22 10:59:07	20.67 KB
prompt.go	2025-07-22 10:59:07	3.91 KB
prompt_test.go	2025-07-22 10:59:07	1.42 KB
protocol.go	2025-07-22 10:59:07	29.45 KB
README.md	2025-07-22 10:59:07	3.43 KB
resource.go	2025-07-22 10:59:07	6.52 KB
resource_go124.go	2025-07-22 10:59:07	634 B
resource_pre_go124.go	2025-07-22 10:59:07	604 B
resource_test.go	2025-07-22 10:59:07	3.49 KB
root.go	2025-07-22 10:59:07	172 B
server.go	2025-07-22 10:59:07	26.04 KB
server_example_test.go	2025-07-22 10:59:07	1.88 KB
server_test.go	2025-07-22 10:59:07	6.36 KB
shared.go	2025-07-22 10:59:07	10.01 KB
shared_test.go	2025-07-22 10:59:07	3.36 KB
sse.go	2025-07-22 10:59:07	14.24 KB
sse_example_test.go	2025-07-22 10:59:07	1.31 KB
sse_test.go	2025-07-22 10:59:07	1.72 KB
tool.go	2025-07-22 10:59:07	8.39 KB
tool_test.go	2025-07-22 10:59:07	3.48 KB
transport.go	2025-07-22 10:59:07	14.03 KB
transport_test.go	2025-07-22 10:59:07	1.74 KB
util.go	2025-07-22 10:59:07	3.94 KB
util_test.go	2025-07-22 10:59:07	1.2 KB

# MCP SDK prototype

[![PkgGoDev](https://pkg.go.dev/badge/golang.org/x/tools)](https://pkg.go.dev/golang.org/x/tools/internal/mcp)

# Contents

1. [Installation](#installation)
1. [Quickstart](#quickstart)
1. [Design](#design)
1. [Testing](#testing)
1. [Code of Conduct](#code-of-conduct)
1. [License](#license)

The mcp package provides a software development kit (SDK) for writing clients
and servers of the [model context
protocol](https://modelcontextprotocol.io/introduction). It is unstable, and
will change in breaking ways in the future. As of writing, it is a prototype to
explore the design space of client/server transport and binding.

# Installation

The mcp package is currently internal and cannot be imported using `go get`.

# Quickstart

Here's an example that creates a client that talks to an MCP server running
as a sidecar process:

```go
package main

import (
	"context"
	"log"
	"os/exec"

"golang.org/x/tools/internal/mcp"
)

func main() {
	ctx := context.Background()
	// Create a new client, with no features.
	client := mcp.NewClient("mcp-client", "v1.0.0", nil)
	// Connect to a server over stdin/stdout
	transport := mcp.NewCommandTransport(exec.Command("myserver"))
	session, err := client.Connect(ctx, transport)
	if err != nil {
		log.Fatal(err)
	}
	defer session.Close()
	// Call a tool on the server.
	params := &mcp.CallToolParams{
		Name:      "greet",
		Arguments: map[string]any{"name": "you"},
	}
	if res, err := session.CallTool(ctx, params); err != nil {
		log.Printf("CallTool failed: %v", err)
	} else {
		if res.IsError {
			log.Print("tool failed")
		}
		for _, c := range res.Content {
			log.Print(c.Text)
		}
	}
}
```

Here is an example of the corresponding server, connected over stdin/stdout:

```go
package main

import (
	"context"

"golang.org/x/tools/internal/mcp"
)

type HiParams struct {
	Name string `json:"name"`
}

func SayHi(ctx context.Context, cc *mcp.ServerSession, params *mcp.CallToolParamsFor[HiParams]) (*mcp.CallToolResultFor[string], error) {
	return &mcp.CallToolResultFor[string]{
		Content: []*mcp.Content{mcp.NewTextContent("Hi " + params.Name)},
	}, nil
}

func main() {
	// Create a server with a single tool.
	server := mcp.NewServer("greeter", "v1.0.0", nil)
	server.AddTools(mcp.NewTool("greet", "say hi", SayHi))
	// Run the server over stdin/stdout, until the client disconnects
	_ = server.Run(context.Background(), mcp.NewStdIOTransport())
}
```

# Design

See [design.md](./design/design.md) for the SDK design. That document is
canonical: given any divergence between the design doc and this prototype, the
doc reflects the latest design.

# Testing

To test your client or server using stdio transport, you can use an in-memory
transport. See [example](server_example_test.go).

To test your client or server using sse transport, you can use the [httptest](https://pkg.go.dev/net/http/httptest)
package. See [example](sse_example_test.go).

# Code of Conduct

This project follows the [Go Community Code of Conduct](https://go.dev/conduct).
If you encounter a conduct-related issue, please mail conduct@golang.org.

# License

Unless otherwise noted, the Go source files are distributed under the BSD-style
license found in the [LICENSE](../../LICENSE) file.

Upon a potential move to the
[modelcontextprotocol](https://github.com/modelcontextprotocol) organization,
the license will be updated to the MIT License, and the license header will
reflect the Go MCP SDK Authors.

云盘

Home / 志元云盘 / webdav / sync / go / pkg / mod / golang.org / x / [email protected] / internal / mcp