McpContentBlock class

Classe base astratta per i blocchi di contenuto di risposta agli strumenti MCP.

La libreria Funzioni di Azure discrimina i blocchi di contenuto dai valori utente semplici usando instanceof McpContentBlock, quindi solo le istanze delle sottoclassi integrate (McpTextContent, McpImageContent, McpAudioContent, McpResourceLinkContent, McpResourceContent) — o una sottoclasse personalizzata che estende questa classe — saranno trattate come blocchi di contenuto.

I letterali di oggetti semplici come { type: 'text', text: '...' }non sono trattati come blocchi di contenuto e verranno invece serializzati come testo JSON.

Estensione con tipi di blocco di contenuto personalizzati

Se la specifica MCP aggiunge un nuovo tipo di blocco — o il tuo scenario ne ha bisogno di uno personalizzato — puoi distribuire la tua sottoclasse senza alcun cambiamento di libreria. Il convertitore controlla instanceof McpContentBlock e chiama JSON.stringify(block)solo , il che invoca U toJSON() per produrre il payload del filo.

Esempio: aggiungere un ipotetico VideoContent

import { McpContentBlock } from '@azure/functions';

export interface VideoContentInit {
    data: string | Buffer | ArrayBuffer;
    mimeType: string;          // e.g. 'video/mp4'
    durationMs?: number;       // optional field from a hypothetical spec
}

export class VideoContent extends McpContentBlock {
    readonly type = 'video' as const;
    readonly data: string | Buffer | ArrayBuffer;
    readonly mimeType: string;
    readonly durationMs?: number;

    constructor(init: VideoContentInit) {
        super();
        this.data = init.data;
        this.mimeType = init.mimeType;
        this.durationMs = init.durationMs;
    }

    toJSON(): Record<string, unknown> {
        const out: Record<string, unknown> = {
            type: this.type,
            data: toBase64(this.data),
            mimeType: this.mimeType,
        };
        if (this.durationMs !== undefined) out.durationMs = this.durationMs;
        return out;
    }
}

function toBase64(data: string | Buffer | ArrayBuffer): string {
    if (typeof data === 'string') return data;
    if (Buffer.isBuffer(data)) return data.toString('base64');
    return Buffer.from(new Uint8Array(data)).toString('base64');
}

Utilizzo di un blocco personalizzato da un gestore di utensili

// Single block
handler: async () => new VideoContent({ data: buf, mimeType: 'video/mp4' })

// Mixed with built-ins + structured content
handler: async () => new McpToolResponse({
    content: [
        new McpTextContent('Detected 3 scenes'),
        new VideoContent({ data: buf, mimeType: 'video/mp4' }),
    ],
    structuredContent: { scenes: 3, confidence: 0.92 },
})

Cosa fa la biblioteca per te

  • instanceof McpContentBlock tratta la tua sottoclasse in modo identico ai blocchi incorporati.
  • I ritorni a blocco singolo propagano la tua type stringa verso il risultato esterno; gli array sono avvolti come multi_content_result.
  • structuredContent Gestione, sintesi di testo di fallback e nullish passthrough si applicano tutti invariati.

Cosa devi fare bene nella tua sottoclasse

  • toJSON() deve restituire la forma esatta del filo richiesta dalle specifiche per il tuo type.
  • I payload binari devono essere codificati toJSON() in base64 (vedi l'aiutante toBase64 sopra).
  • I letterali degli oggetti semplici non sono riconosciuti — devi costruire un'istanza.

Proprietà

type

Metodi

toJSON()

Dettagli proprietà

type

type: string

Valore della proprietà

string

Dettagli metodo

toJSON()

function toJSON(): Record<string, unknown>

Valori restituiti

Record<string, unknown>