8704137635<!-- Provide a brief summary of your changes -->
Update the Go interceptor SDK to use
`github.com/modelcontextprotocol/go-sdk` v1.7.0 custom method APIs and
remove the vendored Go SDK copy. This shouldn't update the behaviours,
but addding following functions.
Changed public/user-facing interfaces:
extension.Extension.Install now returns an error:
```
// before
ext.Install(mcpServer)
// after
if err := ext.Install(mcpServer); err != nil {
return err
}
```
New helper added:
```
extension.RegisterSendingMethods(client *mcp.Client) error
```
## Motivation and Context
<!-- Why is this change needed? What problem does it solve? -->
Pick up MCP Go SDK 1.7.0. This provides upstream custom method support,
so the local vendored SDK copy is no longer needed.
## How Has This Been Tested?
<!-- Have you tested this in a real application? Which scenarios were
tested? -->
- `go test -v ./...`
## Breaking Changes
<!-- Will users need to update their code or configurations? -->
```go
if err := ext.Install(mcpServer); err != nil {
return err
}
```
The Go SDK module now requires Go 1.25 via
github.com/modelcontextprotocol/go-sdk v1.7.0.
## Types of changes
<!-- What types of changes does your code introduce? Put an `x` in all
the boxes that apply: -->
- [ ] Bug fix (non-breaking change which fixes an issue)
- [x] New feature (non-breaking change which adds functionality)
- [x] Breaking change (fix or feature that would cause existing
functionality to change)
- [x] Documentation update
## Checklist
<!-- Go over all the following points, and put an `x` in all the boxes
that apply. -->
- [x] I have read the [MCP
Documentation](https://modelcontextprotocol.io)
- [x] My code follows the repository's style guidelines
- [x] New and existing tests pass locally
- [x] I have added appropriate error handling
- [x] I have added or updated documentation as needed
## Additional context
<!-- Add any other context, implementation notes, or design decisions
-->
LocalChain now registers interceptor custom sending methods internally.
Manual remote chain setup should call
`extension.RegisterSendingMethods(client)` before connecting the MCP
client session used with chain.AddMCPServer.
Signed-off-by: Ukjae Jeong <jeongukjae@gmail.com>
60 lines
1.9 KiB
Markdown
60 lines
1.9 KiB
Markdown
# MCP Interceptors - Go Implementation
|
|
|
|
Go implementation of the MCP Interceptor Extension based on
|
|
[SEP-2624](https://github.com/modelcontextprotocol/modelcontextprotocol/issues/2624).
|
|
|
|
## Quick Start
|
|
|
|
```go
|
|
mcpServer := mcp.NewServer(&mcp.Implementation{
|
|
Name: "my-server",
|
|
Version: "0.1.0",
|
|
}, nil)
|
|
|
|
// Create an extension and register interceptors.
|
|
ext := extension.New()
|
|
|
|
// Register a validator that blocks dangerous tool calls.
|
|
ext.AddInterceptor(&interceptors.Validator{
|
|
Metadata: interceptors.Metadata{
|
|
Name: "block-dangerous",
|
|
Hooks: []interceptors.Hook{{
|
|
Events: []string{interceptors.EventToolsCall},
|
|
Phase: interceptors.PhaseRequest,
|
|
}},
|
|
Mode: interceptors.ModeEnforce,
|
|
},
|
|
Handler: func(_ context.Context, inv *interceptors.Invocation) (*interceptors.ValidationResult, error) {
|
|
raw := inv.Payload.(json.RawMessage)
|
|
var params struct{ Name string `json:"name"` }
|
|
json.Unmarshal(raw, ¶ms)
|
|
// validate the request...
|
|
return &interceptors.ValidationResult{Valid: true}, nil
|
|
},
|
|
})
|
|
|
|
// Install on the server and create a chain for middleware.
|
|
if err := ext.Install(mcpServer); err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
chain, err := ext.LocalChain(ctx, mcpServer)
|
|
mcpServer.AddReceivingMiddleware(gomiddleware.Middleware(chain))
|
|
|
|
mcpServer.Run(context.Background(), &mcp.StdioTransport{})
|
|
```
|
|
|
|
See [`examples/`](examples/) for complete working examples.
|
|
|
|
## Documentation
|
|
|
|
- [**DESIGN.md**](doc/DESIGN.md) — architecture, execution model, integration
|
|
with the go-sdk.
|
|
- [**PERFORMANCE.md**](doc/PERFORMANCE.md) — per-request cost model, allocation
|
|
summary, and optimization notes.
|
|
- [**CONFORMANCE.md**](doc/CONFORMANCE.md) — SEP conformance status.
|
|
|
|
Package API documentation is available via `go doc`:
|
|
|
|
```sh
|
|
go doc github.com/modelcontextprotocol/ext-interceptors/go/sdk/interceptors
|
|
```
|