Add mcp-stateless module: migrate an MCP server from the 2025 stateful protocol to 2026-07-28 on Spring AI 2.1.0
Co-Authored-By: Claude Sonnet 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_017ic4b4tJPXfq5UyiLSFr49
This commit is contained in:
co-authored by
Claude Sonnet 5.5
parent
3aa20a1dce
commit
26e0a3875a
@@ -0,0 +1,80 @@
|
||||
# 2026-07-28 server: how a malformed request fails
|
||||
|
||||
## 1. tools/call without Mcp-Name
|
||||
> POST /mcp
|
||||
> MCP-Protocol-Version: 2026-07-28
|
||||
> Mcp-Method: tools/call
|
||||
> {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"order_status","arguments":{"orderId":"A-101"},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"wire-test","version":"1"},"io.modelcontextprotocol/clientCapabilities":{"elicitation":{"form":{}}}}}}
|
||||
< 400
|
||||
< Content-Type: application/json
|
||||
< {"jsonrpc":"2.0","id":3,"error":{"code":-32020,"message":"Missing required header: Mcp-Name"}}
|
||||
|
||||
## 2. Mcp-Method says tools/list, the body says tools/call
|
||||
> POST /mcp
|
||||
> MCP-Protocol-Version: 2026-07-28
|
||||
> Mcp-Method: tools/list
|
||||
> Mcp-Name: order_status
|
||||
> {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"order_status","arguments":{"orderId":"A-101"},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"wire-test","version":"1"},"io.modelcontextprotocol/clientCapabilities":{"elicitation":{"form":{}}}}}}
|
||||
< 400
|
||||
< Content-Type: application/json
|
||||
< {"jsonrpc":"2.0","id":3,"error":{"code":-32020,"message":"Mcp-Method header does not match request method"}}
|
||||
|
||||
## 3. the version header is present but params._meta is missing
|
||||
> POST /mcp
|
||||
> MCP-Protocol-Version: 2026-07-28
|
||||
> Mcp-Method: tools/list
|
||||
> {"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}
|
||||
< 400
|
||||
< Content-Type: application/json
|
||||
< {"jsonrpc":"2.0","id":2,"error":{"code":-32602,"message":"params._meta is required"}}
|
||||
|
||||
## 4. a protocol version the server does not support
|
||||
> POST /mcp
|
||||
> MCP-Protocol-Version: 2027-01-01
|
||||
> Mcp-Method: tools/list
|
||||
> {"jsonrpc":"2.0","id":2,"method":"tools/list","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2027-01-01"}}}
|
||||
< 400
|
||||
< Content-Type: application/json
|
||||
< {"jsonrpc":"2.0","id":2,"error":{"code":-32022,"message":"Unsupported protocol version","data":{"supported":["2026-07-28"],"requested":"2027-01-01"}}}
|
||||
|
||||
## 5. a 2025-era client's first request, initialize
|
||||
> POST /mcp
|
||||
> {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"wire-test","version":"1"}}}
|
||||
< 400
|
||||
< Content-Type: application/json
|
||||
< {"jsonrpc":"2.0","id":1,"error":{"code":-32020,"message":"Missing required header: Mcp-Method"}}
|
||||
|
||||
## 6. a stray Mcp-Session-Id on a modern request
|
||||
> POST /mcp
|
||||
> MCP-Protocol-Version: 2026-07-28
|
||||
> Mcp-Method: tools/call
|
||||
> Mcp-Name: order_status
|
||||
> Mcp-Session-Id: left-over-from-a-2025-client
|
||||
> {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"order_status","arguments":{"orderId":"A-101"},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"wire-test","version":"1"},"io.modelcontextprotocol/clientCapabilities":{"elicitation":{"form":{}}}}}}
|
||||
< 200
|
||||
< Content-Type: application/json
|
||||
< {"jsonrpc":"2.0","id":3,"result":{"content":[{"type":"text","text":"order A-101 is SHIPPED (answered by instance M1)"}],"isError":false,"resultType":"complete","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"orders","version":"1.0.0"}}}}
|
||||
|
||||
## 7. GET /mcp
|
||||
< 405
|
||||
< Allow: POST
|
||||
|
||||
## 8. unknown tool
|
||||
> POST /mcp
|
||||
> MCP-Protocol-Version: 2026-07-28
|
||||
> Mcp-Method: tools/call
|
||||
> Mcp-Name: nope
|
||||
> {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"nope","arguments":{},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"wire-test","version":"1"},"io.modelcontextprotocol/clientCapabilities":{"elicitation":{"form":{}}}}}}
|
||||
< 400
|
||||
< Content-Type: application/json
|
||||
< {"jsonrpc":"2.0","id":3,"error":{"code":-32602,"message":"Unknown tool: nope"}}
|
||||
|
||||
## 9. a missing argument
|
||||
> POST /mcp
|
||||
> MCP-Protocol-Version: 2026-07-28
|
||||
> Mcp-Method: tools/call
|
||||
> Mcp-Name: order_status
|
||||
> {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"order_status","arguments":{},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"wire-test","version":"1"},"io.modelcontextprotocol/clientCapabilities":{"elicitation":{"form":{}}}}}}
|
||||
< 200
|
||||
< Content-Type: application/json
|
||||
< {"jsonrpc":"2.0","id":3,"result":{"content":[{"type":"text","text":"Invalid arguments: Validation failed: JSON schema validation errors: [: required property 'orderId' not found]"}],"isError":true,"resultType":"complete","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"orders","version":"1.0.0"}}}}
|
||||
Reference in New Issue
Block a user