074dc6cdbd## Summary - Rename `interceptors/mcpserver/` → `interceptors/extension/`, replacing the `Server` wrapper with a lightweight `Extension` that can install itself on any `*mcp.Server` - Remove the stored `*mcp.Server` field — `Extension` is now a pure interceptor container with no server reference - Add `Install(server)` method to register JSON-RPC methods and init middleware on a given server - Update `LocalChain(ctx)` → `LocalChain(ctx, server)` to accept the server as a parameter - Remove `MCPServer()`, `Run()`, and `NewStreamableHTTPHandler()` wrapper methods — users interact with `mcp.Server` directly - Update all examples, tests, and documentation to use the new API ## Why `mcpserver.Server` pretended to *be* the server — it had `Run()`, `NewStreamableHTTPHandler()`, etc. — but it could never cover the full `*mcp.Server` API, so users constantly needed `MCPServer()` to unwrap it. `Extension` doesn't pretend to be the server. It's a pure interceptor container that can install itself on any server (or multiple servers) on the fly. No stored server reference, no wrapping, no delegation surface to maintain. ### Before ```go mcpServer := mcp.NewServer(...) srv := mcpserver.NewServer(mcpServer) srv.AddInterceptor(v) chain, err := srv.LocalChain(ctx) ``` ### After ```go mcpServer := mcp.NewServer(...) ext := extension.New() ext.AddInterceptor(v) ext.Install(mcpServer) chain, err := ext.LocalChain(ctx, mcpServer) ``` Signed-off-by: Kurt Degiorgio <kdegiorgio@bloomberg.net>
34 lines
1.2 KiB
Go
34 lines
1.2 KiB
Go
// Copyright 2025 The MCP Interceptors Authors. All rights reserved.
|
|
// Use of this source code is governed by an Apache-2.0
|
|
// license that can be found in the LICENSE file.
|
|
|
|
// Package gomiddleware provides an optional MCP middleware that
|
|
// automatically executes interceptors for every matching
|
|
// request/response. It uses the [chain.Chain] from the
|
|
// [interceptors/chain] package, which invokes interceptors via
|
|
// interceptor/invoke RPCs per the SEP execution model.
|
|
//
|
|
// The middleware is installed on an [mcp.Server] via
|
|
// [mcp.Server.AddReceivingMiddleware]. It marshals request params
|
|
// and response results to [json.RawMessage], calls
|
|
// [chain.Chain.Execute], and applies any mutated payloads back to
|
|
// the request or response.
|
|
//
|
|
// # Usage
|
|
//
|
|
// // Create interceptor extension (registers interceptors as resources)
|
|
// ext := extension.New()
|
|
// ext.AddInterceptor(myValidator)
|
|
// ext.AddInterceptor(myMutator)
|
|
// ext.Install(mcpServer)
|
|
//
|
|
// // Create chain via in-memory transport
|
|
// chain, err := ext.LocalChain(ctx, mcpServer)
|
|
//
|
|
// // Install middleware for automatic execution
|
|
// mcpServer.AddReceivingMiddleware(
|
|
// gomiddleware.Middleware(chain,
|
|
// gomiddleware.WithLogger(logger),
|
|
// ),
|
|
// )
|
|
package gomiddleware
|