Skip to content

Commit ac37883

Browse files
committed
docs: reconcile every EXAMPLES.md section count with its table rows
Systematic sweep (heading '(N examples)' vs actual rows) — all now match: - Client Examples 6 → 7 entries; Advanced/Composite 5 → 2; Session & State 4 → 3 (lane-qualified); AWS Lambda 4 → 3 (middleware-auth-lambda lives under Middleware); Tool Creation 6 → 5; Tasks 3 → 2; Type Showcases category line 4 → 1 - Added the two examples that had no table row at all: oauth-resource-server (8080) and dynamic-tools-server (8484, 2025-pinned) under Feature-Specific (11 → 13) - Session-Aware Resources stat line replaced with lane-qualified framing (2025-pinned session state vs 2026 request-scoped context) - Category list + stats lines updated to match
1 parent d43ce90 commit ac37883

1 file changed

Lines changed: 16 additions & 14 deletions

File tree

EXAMPLES.md

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ cargo run -p minimal-server
7373
| **function-resource-server** | 8008 | ✅ VALIDATED | Function-based resources | Resource function patterns |
7474
| **session-aware-resource-server** | 8008 | ✅ VALIDATED | Session-aware resources (2025-11-25 pinned) | Session context integration on the stateful lane |
7575

76-
## 🟢 **FEATURE-SPECIFIC SERVERS** (11 examples) - Specialized MCP Features
76+
## 🟢 **FEATURE-SPECIFIC SERVERS** (13 examples) - Specialized MCP Features
7777

7878
| Example | Port | Status | Description | Key Features |
7979
|---------|------|--------|-------------|--------------|
@@ -88,23 +88,25 @@ cargo run -p minimal-server
8888
| **mrtr-elicitation-server** | 8642 | ✅ VALIDATED | MRTR elicitation round trip (2026) | `InputRequired` → retry with `inputResponses`; paired client bin |
8989
| **origin-policy-server** | 8643 | ✅ VALIDATED | Origin validation / DNS-rebinding (2026) | `OriginPolicy` default/AllowList/Disabled; 403 matrix verified live |
9090
| **header-bound-tools-server** | 8644 | ✅ VALIDATED | SEP-2243 header-bound tool params (2026) | `x-mcp-header``Mcp-Param-*` mirroring; -32001 contract verified live |
91+
| **oauth-resource-server** | 8080 | ✅ VALIDATED | OAuth 2.1 Resource Server (RFC 9728) | JWKS Bearer validation, PRM well-known routes, `--required-scope` → 403 insufficient_scope |
92+
| **dynamic-tools-server** | 8484 | ✅ VALIDATED | Dynamic tool registration (2025-pinned) | `ToolRegistry` + `notifications/tools/list_changed` on the stateful lane |
9193

92-
## 🔵 **ADVANCED/COMPOSITE SERVERS** (5 examples) - Complex Functionality
94+
## 🔵 **ADVANCED/COMPOSITE SERVERS** (2 examples) - Complex Functionality
9395

9496
| Example | Port | Status | Description | Advanced Features |
9597
|---------|------|--------|-------------|-------------------|
9698
| **audit-trail-server** | 8009 | ✅ VALIDATED | Audit logging | Comprehensive audit logging system |
9799
| **zero-config-getting-started** | 8641 | ✅ VALIDATED | Zero-configuration setup | Getting started tutorial server |
98100

99-
## 🔴 **SESSION & STATE** (4 examples) - Advanced State Handling
101+
## 🔴 **SESSION & STATE** (3 examples) - Advanced State Handling (2025-pinned lane)
100102

101103
| Example | Port | Status | Description | Session Features |
102104
|---------|------|--------|-------------|------------------|
103105
| **stateful-server** | 8006 | ✅ VALIDATED | Advanced stateful operations (2025-11-25 pinned) | Session state management on the stateful lane |
104106
| **session-logging-proof-test** | 8001 | ✅ VALIDATED | Session logging validation | Session-based logging verification |
105107
| **logging-test-server** | 8052 | ✅ VALIDATED | Logging test suite | Comprehensive logging test suite |
106108

107-
## 🟠 **CLIENT EXAMPLES** (6 examples) - Client Implementation
109+
## 🟠 **CLIENT EXAMPLES** (7 entries) - Client Implementation
108110

109111
| Example | Type | Status | Description | Purpose |
110112
|---------|------|--------|-------------|---------|
@@ -125,15 +127,15 @@ cargo run -p client-initialise-server
125127
cargo run -p client-initialise-report -- --url http://127.0.0.1:8641/mcp
126128
```
127129

128-
## ☁️ **AWS LAMBDA** (4 examples) - Serverless Deployment
130+
## ☁️ **AWS LAMBDA** (3 examples) - Serverless Deployment (middleware-auth-lambda is listed under Middleware)
129131

130132
| Example | Type | Status | Description | AWS Features |
131133
|---------|------|--------|-------------|--------------|
132134
| **lambda-mcp-server** | Lambda | ✅ VALIDATED | Serverless MCP server | Basic Lambda deployment |
133135
| **lambda-mcp-client** | Lambda Client | ✅ VALIDATED | Lambda MCP client | AWS Lambda client integration |
134136
| **lambda-authorizer** | Lambda | ✅ VALIDATED | API Gateway authorizer | REQUEST authorizer with wildcard methodArn for MCP |
135137

136-
## 🟣 **TOOL CREATION & OUTPUT SCHEMAS** (6 examples) - Tool Patterns
138+
## 🟣 **TOOL CREATION & OUTPUT SCHEMAS** (5 examples) - Tool Patterns
137139

138140
| Example | Port | Status | Description | Key Features |
139141
|---------|------|--------|-------------|--------------|
@@ -152,7 +154,7 @@ cargo run -p client-initialise-report -- --url http://127.0.0.1:8641/mcp
152154
| **middleware-rate-limit-server** | 8671 | ✅ VALIDATED | Rate limiting | Per-session request counting |
153155
| **middleware-auth-lambda** | Lambda | ✅ VALIDATED | Lambda auth middleware | API Gateway authorizer context (V1 nested, V1 flat, V2) with Streamable HTTP (REST API V1) |
154156

155-
## 🔄 **TASKS (MCP 2025-11-25)** (3 examples) - Long-Running Operations
157+
## 🔄 **TASKS (MCP 2025-11-25)** (2 examples) - Long-Running Operations
156158

157159
| Example | Type | Status | Description | Task Features |
158160
|---------|------|--------|-------------|---------------|
@@ -187,15 +189,15 @@ re-verified its six examples live on the wire.
187189
- **Getting Started** - 5 examples (all tool creation levels)
188190
- **Session Storage** - 3 examples (SQLite, PostgreSQL, DynamoDB)
189191
- **Resource Servers** - 6 examples (session-aware resources)
190-
- **Feature-Specific** - 11 examples (prompts, sampling, elicitation, MRTR, origin policy, header binding, etc.)
192+
- **Feature-Specific** - 13 examples (prompts, sampling, elicitation, MRTR, origin policy, header binding, OAuth RS, etc.)
191193
- **Advanced/Composite** - audit-trail, pagination, icon showcase
192194
- **Session & State** - stateful-server + session-aware-resource-server (2025-pinned) and the storage-backend trio
193195
- **Client Examples** - see the pairs table above (9 pairing rows)
194-
- **AWS Lambda** - 4 examples (server, streaming, client, authorizer)
195-
- **Tool Creation & Schemas** - 6 examples (macro patterns + output schemas)
196+
- **AWS Lambda** - 3 examples (server, client, authorizer) + middleware-auth-lambda under Middleware
197+
- **Tool Creation & Schemas** - 5 examples (macro patterns + output schemas)
196198
- **Middleware** - 4 examples (auth, logging, rate-limiting, Lambda auth)
197-
- **Tasks** - 3 examples (MCP 2025-11-25 task lifecycle)
198-
- **Type Showcases** - 4 examples (print-only type demonstrations)
199+
- **Tasks** - 2 examples (MCP 2025-11-25 task lifecycle)
200+
- **Type Showcases** - 1 example (print-only type demonstrations)
199201

200202
> Lane-by-lane compilation is enforced by CI (`scripts/ci-gates.sh all`); the
201203
> 2026-06-12 disposition slices live-verified every migrated and new example.
@@ -209,12 +211,12 @@ re-verified its six examples live on the wire.
209211

210212
### 📊 **Statistics**
211213
- **Total Examples**: 53 active (29 archived in `examples/archived/`)
212-
- **Session-Aware Resources**: 6 examples demonstrating session context integration
214+
- **Session state (2025-pinned lane)**: stateful-server, session-aware-resource-server, and the logging/session test fixtures demonstrate cross-request session state on the opt-in lane; 2026-default examples use request-scoped context or app-owned storage instead
213215
- **Client-Server Pairs**: 9 pairing-table rows validating communication patterns
214216
- **Task Support**: 3 examples demonstrating MCP 2025-11-25 task lifecycle (InMemory storage)
215217
- **Middleware**: 4 examples (HTTP auth, logging, rate-limiting, Lambda auth)
216218
- **Storage Backends**: All 4 session backends (InMemory, SQLite, PostgreSQL, DynamoDB) working
217-
- **AWS Lambda Integration**: 4 examples (server, streaming, client, API Gateway authorizer)
219+
- **AWS Lambda Integration**: 3 examples (server, client, API Gateway authorizer) + middleware-auth-lambda
218220

219221
### 🔧 **Running Examples**
220222

0 commit comments

Comments
 (0)