[Capability] Describe nullable parameters with `anyOf` instead of a `type` array?
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Idoneità per principianti
- 25/100
Direzione di ricerca
Start in SchemaGenerator, where a nullable parameter currently produces a type array such as ["null", "string"]; find the branch that builds that array and the tests covering nullable scalars, enums, arrays and objects. The open question is a design one, so the first deliverable is a maintainer answer on whether anyOf should be default or opt-in before any patch. Done means every nullable parameter shape is covered and existing schema tests are updated alongside the new behaviour.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
For a nullable parameter, SchemaGenerator emits a type array. With mcp/sdk 0.9.0, the ?string $company = null parameter of a tool gets:
{"type": ["null", "string"], "description": "The company of the speaker", "default": null}
MCP Inspector 2 then reports "Schema portability: 0 errors, 1 warning" and suggests {"anyOf": [{"type": "null"}, {"type": "string"}]}. That rule is a warning on purpose (schemaLint.ts, modelcontextprotocol/inspector#2286). The array form is what OpenAI recommends. It only costs portability to clients that map tool schemas onto a dialect with a single type.
What the providers document:
- OpenAI: "it is possible to emulate an optional parameter by using a union type with
null", with"type": ["string", "null"]in the examples.anyOfworks too, except at the root. - Anthropic: strict tool use supports
anyOf, and countsanyOfand type arrays the same in its limit on union types. - Gemini: the
parametersof a function declaration use "a select subset of an OpenAPI 3.0 schema object". Itstypeis a single value, withanyOf,nullableand aNULLtype. So only theanyOfform maps onto it.parametersJsonSchematakes JSON Schema instead.
Switching to anyOf would change the schema of every nullable parameter, including enums, arrays and objects, and clients that read type wouldn't find it anymore. So I'd rather ask first. Would you take a PR that emits anyOf for nullable parameters, maybe as an option of SchemaGenerator?
Found with the submit_proposal tool of the MCP server of the Symfony showcase app.
- Lingua principale
- PHP
- Stelle
- 1.7k
- Fork
- 206
- Merge medio
- 1g 17h
- PR unite (30g)
- 102
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Nessun modello di pull request
- Leggi la 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 modelcontextprotocol/php-sdk
-
Difficoltà 1/5 1-3 ore Idoneità per principianti 85/100
modelcontextprotocol/php-sdk#746 ·
I maintainer di solito rispondono entro 1 giorno
-
[Server] Handler type uses bare Closure, hard to decorate RegistryInterface under strict PHPStanApertaServer
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 78/100
modelcontextprotocol/php-sdk#468 · 3 commenti ·
I maintainer di solito rispondono entro 1 giorno
-
enhancement P3
Difficoltà 4/5 3-5 giorni Idoneità per principianti 48/100
modelcontextprotocol/php-sdk#733 · 2 commenti ·
I maintainer di solito rispondono entro 1 giorno
-
[Server] Handle notifications/cancelled on the handshake eraForse già presa @ump45nose l’ha presa 5 giorni fa. Apertahelp wanted improves spec compliance Server
Difficoltà 4/5 3-5 giorni Idoneità per principianti 57/100
modelcontextprotocol/php-sdk#732 ·
I maintainer di solito rispondono entro 1 giorno
-
[Client][Server] Ship extension classes for the two authorization extensionsForse già presa @chr-hertel l’ha presa 6 giorni fa. Apertaauth Client Server
modelcontextprotocol/php-sdk#721 · 1 assegnatario ·
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di modelcontextprotocol/php-sdk
Issue simili
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 82/100
pluginsGLPI/carbon#396 ·
-
[BUG] Bundle products lose their price in RSS feeds: getPrices() was removedForse già presa @pcvelz l’ha presa oggi. Aperta
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 90/100
OpenMage/magento-lts#5869 ·
I maintainer di solito rispondono entro 2 giorni
-
Map Info Window ButtonsAperta
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 90/100
OpenGIS/waymark-wp#82 ·
-
bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
I maintainer di solito rispondono entro 1 giorno
-
claude
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
sprain/sprainocchio#39 ·
I maintainer di solito rispondono entro 1 giorno