MCP tool schemas using $ref/$defs cause 400 on every request with Moonshot/Kimi models
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 4/5
- Geschätzter Aufwand
- 3-5 Tage
- Anfängerfreundlichkeit
- 48/100
Rechercherichtung
Beginne am cmd-Einstiegspunkt und verfolge, wie MCP-Tool-Schemas konvertiert werden, bevor Provider-Anfragen gesendet werden; das Issue nennt keine Repository-Dateien oder Tests. Vergleiche den Moonshot-Pfad mit den Pfaden von Claude Code und Codex und überprüfe anschließend, dass das gemeldete $ref/$defs-Schema keinen 400-Fehler mehr verursacht und die Sitzung weiterhin nutzbar ist.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
Summary
When an MCP server exposes a tool whose input schema uses $ref + $defs (valid JSON Schema, and valid per the MCP spec), Command Code passes the schema to the Moonshot/Kimi API in a form it rejects — and because tool definitions accompany every request, every turn of the session fails with a 400, making the CLI unusable with that MCP server attached.
Error
⚠ Error: 400 Invalid request: tools.function.parameters is not a valid moonshot flavored
json schema, details: <At path 'properties.external.$ref': $defs not found for reference:
#/$defs/IdentifySessionExternalParams>
Seen on v0.51.0 and still present after updating to v0.52.1, model moonshotai/Kimi-K2.7-Code-Highspeed.
Repro
- Configure any MCP server that emits a
$ref-based tool schema. In my case: the Solo app's MCP server, whoseidentify_sessiontool declares:
{
"$defs": {
"IdentifySessionExternalParams": {
"properties": {
"agent_id": {"type": "string"},
"metadata": {"additionalProperties": true, "default": {}, "type": "object"},
"name": {"type": "string"}
},
"required": ["name"],
"type": "object"
}
},
"properties": {
"external": {
"$ref": "#/$defs/IdentifySessionExternalParams",
"description": "External actor details for callers that are not Solo-managed processes."
},
"solo_process_id": {"format": "int64", "type": "integer"},
"pid": {"format": "uint32", "minimum": 0, "type": "integer"}
},
"type": "object"
}
- Start
cmdwith a Kimi model and send any message. - Every request 400s with the error above.
Note the schema does include a top-level $defs — the Moonshot error says $defs not found, which suggests the conversion layer strips/loses $defs while leaving the $ref dangling (or Moonshot's "flavored" schema simply doesn't support refs at all).
Expected
Command Code should dereference/inline $refs when converting MCP tool schemas for providers whose "flavored" JSON Schema doesn't support them (Moonshot at minimum). Claude Code and Codex handle the same MCP server fine because the Anthropic/OpenAI APIs accept $ref schemas.
A degraded-but-better alternative: drop the offending tool from the tool list with a warning, instead of letting one incompatible schema hard-fail the entire session.
Workaround
Disable the offending MCP server in ~/.commandcode/mcp.json ("enabled": false).
- Vorherrschende Sprache
- Keine Sprachdaten
- Sterne
- 4k
- Forks
- 350
- PR-Merge-Kennzahlen
- Keine gemergten PRs in 30 T.
Beitragsleitfaden
Für dieses Repository ist kein Beitragsleitfaden indexiert
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus CommandCodeAI/command-code
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100
CommandCodeAI/command-code#855 ·
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
CommandCodeAI/command-code#841 · 1 Kommentar ·
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100
CommandCodeAI/command-code#655 · 1 Kommentar ·
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100
CommandCodeAI/command-code#608 ·
-
Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 70/100
CommandCodeAI/command-code#893 ·
Alle Issues in CommandCodeAI/command-code
Ähnliche Issues
-
bug priority:normal ready-for-dev
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 88/100
OpenHands/extensions#626 · 1 Kommentar ·
-
bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100
avniproject/avni-client#2135 ·
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 88/100
-
needs-triage
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
use-agent-os/agent-os#3276 ·