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>
39 lines
1.2 KiB
Go
39 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 chain provides the SEP-compliant interceptor chain
|
|
// orchestrator. It discovers interceptors from MCP servers via
|
|
// "interceptors/list" and invokes them via "interceptor/invoke",
|
|
// implementing trust-boundary-aware execution ordering.
|
|
//
|
|
// # Execution Model
|
|
//
|
|
// [Chain.Execute] filters registered interceptors by event and phase,
|
|
// separates them into validators and mutators, and runs them in the
|
|
// SEP-defined order:
|
|
//
|
|
// Request phase (untrusted → trusted):
|
|
//
|
|
// Validate (parallel) → Mutate (sequential)
|
|
//
|
|
// Response phase (trusted → untrusted):
|
|
//
|
|
// Mutate (sequential) → Validate (parallel)
|
|
//
|
|
// # Usage
|
|
//
|
|
// A [Chain] is created with [NewChain] and populated by adding MCP
|
|
// servers via [Chain.AddMCPServer]:
|
|
//
|
|
// chain := chain.NewChain()
|
|
// chain.AddMCPServer(ctx, clientSession)
|
|
// mcpServer.AddReceivingMiddleware(
|
|
// gomiddleware.Middleware(chain),
|
|
// )
|
|
//
|
|
// For convenience, [extension.Extension.LocalChain] creates a chain
|
|
// pre-configured with a local in-process MCP server:
|
|
//
|
|
// chain, err := ext.LocalChain(ctx, mcpServer)
|
|
package chain
|