[Bug]: CLI MCP generator omits MCP-Protocol-Version after initialization

Aperta Adatta ai principianti
#4,343 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

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
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
go
Ambito
api, cli

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

Aspect/AI Aspect/API. Severity/Major
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
  1. Download and extract the official CLI release ap/v0.9.1.

  2. Download reproduce_mcp.py (Python standard library only).

  3. Run:

    python reproduce_mcp.py --binary /absolute/path/to/ap --case protocol_header --case protocol_header_control
    

    On Windows use --binary "C:\tools\ap.exe" and python or py as 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

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 main at 398d50772b5605ffe0d6d8693aa7b9ce7c84032e; 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

Screenshot of captured CLI output and request headers for the protocol-version cases

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

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di wso2/api-platform

Tutte le issue di wso2/api-platform

Issue simili

Altre issue su Go

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.