Rename mcpserver package to extension, remove *mcp.Server field (#11)
## 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>
This commit is contained in:
parent
c9900f02ab
commit
074dc6cdbd
1 changed files with 172 additions and 173 deletions
|
|
@ -1,52 +0,0 @@
|
|||
// 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 mcpserver registers interceptors as first-class MCP
|
||||
// primitives. Adding an interceptor to the server makes it
|
||||
// discoverable via "interceptors/list" and invocable via
|
||||
// "interceptor/invoke", so any MCP client — local or remote — can
|
||||
// discover and call interceptors using standard JSON-RPC.
|
||||
//
|
||||
// # Getting Started
|
||||
//
|
||||
// Wrap an existing [mcp.Server] with [NewServer] and register
|
||||
// interceptors:
|
||||
//
|
||||
// srv := mcpserver.NewServer(mcpServer, mcpserver.WithLogger(logger))
|
||||
// srv.AddInterceptor(myValidator)
|
||||
// srv.AddInterceptor(myMutator)
|
||||
// srv.Run(ctx, transport)
|
||||
//
|
||||
// At this point any connected MCP client can call interceptors/list
|
||||
// and interceptor/invoke.
|
||||
//
|
||||
// For convenience, [Server.LocalChain] creates a [chain.Chain] wired
|
||||
// to the server over an in-memory transport, ready for use with the
|
||||
// gomiddleware package:
|
||||
//
|
||||
// chain, err := srv.LocalChain(ctx)
|
||||
// mcpServer.AddReceivingMiddleware(
|
||||
// gomiddleware.Middleware(chain,
|
||||
// gomiddleware.WithContextProvider(myProvider),
|
||||
// ),
|
||||
// )
|
||||
//
|
||||
// # JSON-RPC Methods
|
||||
//
|
||||
// The server registers two JSON-RPC methods:
|
||||
//
|
||||
// - "interceptors/list": Returns all registered interceptors,
|
||||
// optionally filtered by event name.
|
||||
// - "interceptor/invoke": Invokes a single interceptor by name
|
||||
// for a given event, phase, and payload.
|
||||
//
|
||||
// # Transports
|
||||
//
|
||||
// The server works with any transport supported by the go-sdk.
|
||||
// For stdio, use [Server.Run]. For HTTP, use
|
||||
// [NewStreamableHTTPHandler]:
|
||||
//
|
||||
// handler := mcpserver.NewStreamableHTTPHandler(srv, nil)
|
||||
// http.ListenAndServe(":8080", handler)
|
||||
package mcpserver
|
||||
Loading…
Reference in a new issue