webdav/sync/go/pkg/mod/golang.org/x/tools@v0.35.1-0.20250728180453-01a3475a31bc/internal/mcp - 志元云盘

File OriginalPic	EditTime	Size
design	2025-08-07 14:22:36	53.77 KB
examples	2025-08-07 14:22:36	4.01 KB
internal	2025-08-07 14:22:36	8.82 KB
jsonschema	2025-08-07 14:22:36	432.74 KB
testdata	2025-08-07 14:22:36	5.75 KB
client.go	2025-08-07 14:22:36	16.5 KB
client_list_test.go	2025-08-07 14:22:36	5.06 KB
client_test.go	2025-08-07 14:22:36	5.07 KB
cmd.go	2025-08-07 14:22:36	2.9 KB
cmd_test.go	2025-08-07 14:22:36	1.76 KB
conformance_go124_test.go	2025-08-07 14:22:36	348 B
conformance_go125_test.go	2025-08-07 14:22:36	313 B
conformance_test.go	2025-08-07 14:22:36	9.95 KB
content.go	2025-08-07 14:22:36	4.25 KB
content_test.go	2025-08-07 14:22:36	2.56 KB
CONTRIBUTING.md	2025-08-07 14:22:36	13.41 KB
create-repo.sh	2025-08-07 14:22:36	2.96 KB
example_progress_test.go	2025-08-07 14:22:36	821 B
features.go	2025-08-07 14:22:36	3 KB
features_test.go	2025-08-07 14:22:36	2.26 KB
generate.go	2025-08-07 14:22:36	19.03 KB
logging.go	2025-08-07 14:22:36	5.17 KB
mcp.go	2025-08-07 14:22:36	1.78 KB
mcp_test.go	2025-08-07 14:22:36	22.92 KB
mcp-repo-replace.txt	2025-08-07 14:22:36	778 B
prompt.go	2025-08-07 14:22:36	479 B
protocol.go	2025-08-07 14:22:36	30.26 KB
README.md	2025-08-07 14:22:36	4.46 KB
resource.go	2025-08-07 14:22:36	6.52 KB
resource_go124.go	2025-08-07 14:22:36	634 B
resource_pre_go124.go	2025-08-07 14:22:36	604 B
resource_test.go	2025-08-07 14:22:36	3.49 KB
root.go	2025-08-07 14:22:36	172 B
server.go	2025-08-07 14:22:36	27.24 KB
server_example_test.go	2025-08-07 14:22:36	1.89 KB
server_test.go	2025-08-07 14:22:36	6.36 KB
shared.go	2025-08-07 14:22:36	10.29 KB
shared_test.go	2025-08-07 14:22:36	3.38 KB
sse.go	2025-08-07 14:22:36	16.12 KB
sse_example_test.go	2025-08-07 14:22:36	1.32 KB
sse_test.go	2025-08-07 14:22:36	3.71 KB
streamable.go	2025-08-07 14:22:36	21.58 KB
streamable_test.go	2025-08-07 14:22:36	16.44 KB
tool.go	2025-08-07 14:22:36	8.68 KB
tool_test.go	2025-08-07 14:22:36	3.53 KB
transport.go	2025-08-07 14:22:36	13.72 KB
transport_test.go	2025-08-07 14:22:36	1.4 KB
util.go	2025-08-07 14:22:36	3.94 KB
util_test.go	2025-08-07 14:22:36	1.2 KB

# MCP Go SDK

[![PkgGoDev](https://pkg.go.dev/badge/golang.org/x/tools)](https://pkg.go.dev/github.com/modelcontextprotocol/go-sdk)

This repository contains an implementation of the official Go software
development kit (SDK) for the Model Context Protocol (MCP).

**WARNING**: The SDK is currently unstable and subject to breaking changes.
Please test it out and file bug reports or API proposals. The [TODO](#todo)
section below outlines outstanding release blockers. We aim to release a stable
version of the SDK in mid July, 2025.

1. [Package documentation](#package-documentation)
	1. [Example](#example)
	1. [TODO](#todo)
	1. [Design](#design)
	1. [Acknowledgements](#acknowledgements)
	1. [License](#license)

## Package documentation

The SDK consists of two importable packages:

- The
  [`github.com/modelcontextprotocol/go-sdk/mcp`](https://pkg.go.dev/golang.org/x/tools/internal/mcp)
  package defines the primary APIs for constructing and using MCP clients and
  servers.
- The
  [`github.com/modelcontextprotocol/go-sdk/jsonschema`](https://pkg.go.dev/golang.org/x/tools/internal/mcp/jsonschema)
  package provides an implementation of [JSON
  Schema](https://json-schema.org/), used for MCP tool input and output schema.

## Example

In this example, an MCP client communicates with an MCP server running in 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"},
	}
	res, err := session.CallTool(ctx, params)
	if err != nil {
		log.Fatalf("CallTool failed: %v", err)
	}
	if res.IsError {
		log.Fatal("tool failed")
	}
	for _, c := range res.Content {
		log.Print(c.Text)
	}
}
```

Here's an example of the corresponding server component, which communicates
with its client over stdin/stdout:

```go
package main

import (
	"context"
	"log"

"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[any], error) {
	return &mcp.CallToolResultFor[any]{
		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.NewServerTool("greet", "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)
	}
}
```

The `examples/` directory contains more example clients and servers.

## TODO

The following TODOs block the release of this SDK:

- Better support for resumability in the Streamable HTTP transport: a
  server-side event store and client-side retry configuration.
- OAuth support (or examples of implementing OAuth using middleware).
- Support for the changes in the
  [2025-06-18](https://modelcontextprotocol.io/specification/2025-06-18/changelog)
  version of the MCP spec.
- More examples and documentation.

## Design

The design doc for this SDK is at [design.md](./design/design.md), which was
initially reviewed at
[modelcontextprotocol/discussions/364](https://github.com/orgs/modelcontextprotocol/discussions/364).

Further design discussion should occur in GitHub issues. See CONTRIBUTING.md
for details.

## Acknowledgements

Several existing Go MCP SDKs inspired the development and design of this
official SDK, notably [mcp-go](https://github.com/mark3labs/mcp-go), authored
by Ed Zynda. We are grateful to Ed as well as the other contributors to mcp-go,
and to authors and contributors of other SDKs such as
[mcp-golang](https://github.com/metoro-io/mcp-golang) and
[go-mcp](https://github.com/ThinkInAIXYZ/go-mcp). Thanks to their work, there
is a thriving ecosystem of Go MCP clients and servers.

## License

This project is licensed under the MIT License - see the [LICENSE](./LICENSE)
file for details.

云盘

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