McpContentBlock class

Clase base abstracta para bloques de contenido de respuesta a la herramienta MCP.

La biblioteca Azure Functions discrimina bloques de contenido de los valores de usuario simples usando instanceof McpContentBlock, por lo que solo las instancias de las subclases integradas (McpTextContent, McpImageContent, McpAudioContent, McpResourceLinkContent, McpResourceContent) — o una subclase personalizada que extiende esta clase — serán tratadas como bloques de contenido.

Los literales de objetos simples como { type: 'text', text: '...' }no se tratan como bloques de contenido y se serializarán como texto JSON en su lugar.

Ampliación con tipos de bloque de contenido personalizados

Si la especificación MCP añade un nuevo tipo de bloque —o tu escenario necesita uno personalizado— puedes enviar tu propia subclase sin ningún cambio de librería. El convertidor solo comprueba instanceof McpContentBlock y llama JSON.stringify(block), lo que invoca a U toJSON() para producir la carga útil de cable.

Ejemplo: añadir un hipotético 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');
}

Uso de un bloque personalizado de un manejador de herramientas

// 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 },
})

Lo que la biblioteca hace por ti

  • instanceof McpContentBlock trata tu subclase de forma idéntica a los bloques incorporados.
  • Los retornos de bloque único propagan tu type cadena al resultado externo; los arrays se envuelven como multi_content_result.
  • structuredContent El manejo, la síntesis de texto de respaldo y el paso nulo se aplican sin cambios.

Lo que debes acertar en tu subclase

  • toJSON() debe devolver la forma exacta del cable que la especificación requiere para tu type.
  • Las cargas útiles binarias deben codificarse en toJSON() base64 (véase el toBase64 asistente anterior).
  • Los literales de objetos simples no se reconocen: debes construir una instancia.

Propiedades

type

Métodos

toJSON()

Detalles de las propiedades

type

type: string

Valor de propiedad

string

Detalles del método

toJSON()

function toJSON(): Record<string, unknown>

Devoluciones

Record<string, unknown>