[Bug]: CLI MCP generator omits MCP-Protocol-Version after initialization
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 2/5
- Tempo stimato
- 1-3 ore
- Idoneità per principianti
- 77/100
Direzione di ricerca
Leggi cli/src/internal/mcp/generator.go, in particolare la costruzione dell’header della richiesta successiva vicino alla riga 219 e la gestione della risposta di inizializzazione vicino alla riga 305. Segui il percorso della versione del protocollo negoziata e dell’ID di sessione nel generatore, poi aggiungi test per un endpoint senza stato che richiede l’header. L’obiettivo è che le richieste successive all’inizializzazione inviino la versione negoziata e che gli header di autenticazione forniti dal chiamante continuino a funzionare.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
Description
ap gateway mcp generate in WSO2 API Platform CLI ap v0.9.1 proposes MCP protocol version 2025-06-18 during initialization but does not send the MCP-Protocol-Version HTTP header on subsequent requests.
A local stateless server that advertises that version and requires the version header rejects discovery. Supplying the same header manually with the CLI's --header option makes the identical discovery sequence succeed.
Steps to Reproduce
-
Download and extract the official CLI release
ap/v0.9.1. -
Download reproduce_mcp.py (Python standard library only).
-
Run:
python reproduce_mcp.py --binary /absolute/path/to/ap --case protocol_header --case protocol_header_controlOn Windows use
--binary "C:\tools\ap.exe"andpythonorpyas appropriate.
The first fixture returns a successful initialize result with protocolVersion: 2025-06-18, issues no session ID, and requires MCP-Protocol-Version: 2025-06-18 on later POSTs; otherwise it returns HTTP 400 with a JSON-RPC error. The control case uses the same fixture and only adds --header "MCP-Protocol-Version: 2025-06-18" to the CLI command.
Actual result
| Case | CLI exit | Echo tool in output | MCP-Protocol-Version sent |
|---|---|---|---|
protocol_header |
1 | No | Missing on every post-initialization request |
protocol_header_control |
0 | Yes | 2025-06-18 on every request |
Failing case stderr:
Error: tools/list request returned an error: Unsupported protocol version: missing MCP-Protocol-Version
The captured request log shows protocol_header: null for initialize, notifications/initialized, tools/list, prompts/list and resources/list in the failing case, and 2025-06-18 for all five in the control case.
Expected result
The CLI should retain the version negotiated during initialization and attach it to subsequent HTTP protocol requests automatically, while preserving any caller-supplied authentication headers. The MCP protocol-version header requirement applies to post-initialization requests; a stateless server cannot recover the version from a session ID.
Source evidence and suggested direction
- Subsequent request headers set content type, accept, an optional caller-supplied header and a session ID, but never the negotiated protocol version.
- Initialization response handling checks for an error but does not retain
result.protocolVersion.
Carry the negotiated version alongside the session ID and set the header for later protocol requests. Add coverage with a stateless endpoint that requires the header.
Environment Details
- Product/component: WSO2 API Platform CLI, official Linux amd64 release
ap/v0.9.1(ap version v0.9.1 (built at 2026-08-07T09:04:19Z)). - Test runtime: Linux 6.18.57 x86_64 with glibc 2.41, Python 3.12.14.
- Source reviewed: api-platform
mainat398d50772b5605ffe0d6d8693aa7b9ce7c84032e; inspected, not compiled or executed. - All fixtures advertise tools, prompts, resources and logging capabilities, so the separately reported optional-capability issue does not apply here.
- Evidence boundary: local mock server only; not tested against a WSO2-hosted product instance. No CVSS score is asserted.
Area / Aspect / Severity
Area: CLI. Aspect: Aspect/AI and Aspect/API. Severity: Severity/Major (provisional functional assessment for maintainer review).
Screenshot and attachments
- Lingua principale
- Go
- Stelle
- 85
- Fork
- 137
- Merge medio
- 1g 12h
- PR unite (30g)
- 247
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Nessuna guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di wso2/api-platform
-
Area/DeveloperPortal Aspect/UI Severity/Minor Type/Bug
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 88/100
wso2/api-platform#4369 ·
I maintainer di solito rispondono entro 1 giorno
-
[Bug]: host-rewrite policy documentation lists fewer allowed host characters than the policy acceptsApertaArea/Policies Aspect/Other Severity/Trivial Type/Bug
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 91/100
wso2/api-platform#4355 ·
I maintainer di solito rispondono entro 1 giorno
-
Area/Gateway Aspect/API Severity/Minor Type/Bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
wso2/api-platform#4348 ·
I maintainer di solito rispondono entro 1 giorno
-
[Bug]: content-length-guardrail policy accepts a non-string streamingJsonPath at API creationApertaArea/Policies Aspect/Configuration Severity/Minor Type/Bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 74/100
wso2/api-platform#4330 ·
I maintainer di solito rispondono entro 1 giorno
-
Area/Policies Aspect/API Aspect/Configuration Severity/Minor Type/Bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 83/100
wso2/api-platform#4329 ·
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di wso2/api-platform
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 88/100
I maintainer di solito rispondono entro 1 giorno
-
security
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 73/100
keyxmakerx/Chronicle#2285 ·
I maintainer di solito rispondono entro 1 giorno