No support for structuredContent in tool results (MCP spec 2025-06-18)

Aperta Adatta ai principianti
  • Qualcosa non va?
#104 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
76/100
Tipo di issue
Funzionalità
Chiarezza
Specificata chiaramente
Stato di attività
Tranquilla
Stack tecnologico
r
Ambito
api

Direzione di ricerca

Inizia individuando e leggendo as_tool_call_result(), concentrandoti su come vengono attualmente serializzati i risultati di tipo lista e gli oggetti Content di ellmer. Aggiungi structuredContent per i risultati di tipo lista mantenendo il testo serializzato in content e preserva il comportamento esistente per gli oggetti Content. Verifica che i risultati degli strumenti contengano entrambe le rappresentazioni e considera la relazione con outputSchema nell’issue #103.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Problem

The MCP spec (2025-06-18) defines a structuredContent field on tool results — a JSON object that provides machine-readable structured output alongside the human-readable content text.

Currently, as_tool_call_result() only produces content (text-only). There's no path for structuredContent.

Expected

When a tool returns a list/data structure, the result should include both:

{
  "content": [
    {"type": "text", "text": "{\"auc\": 0.92, \"tss\": 0.81}"}
  ],
  "structuredContent": {
    "auc": 0.92,
    "tss": 0.81
  }
}
  • content: Human-readable text (for backwards compatibility)
  • structuredContent: Machine-readable JSON (for clients that support it)

Per spec: "For backwards compatibility, a tool that returns structured content SHOULD also return the serialized JSON in a TextContent block."

Use Case

SDM MCP server with ~70 tools. Each tool produces structured results (model metrics, file paths, area statistics). Clients that understand structuredContent get validated, typed data. Others fall back to text. This is the biggest quality-of-life improvement for tool-heavy servers.

Fix

In as_tool_call_result(), if the tool result is a list (and not an ellmer Content object), include it as structuredContent alongside the text serialization.

Related to #103 (outputSchema) — if a tool declares an outputSchema, the structuredContent should be validated against it.

Lingua principale
R
Stelle
204
Fork
23
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

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 posit-dev/mcptools

Tutte le issue di posit-dev/mcptools

Issue simili

Altre issue su R

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.