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 McpContentBlocktrata tu subclase de forma idéntica a los bloques incorporados. - Los retornos de bloque único propagan tu
typecadena al resultado externo; los arrays se envuelven comomulti_content_result. -
structuredContentEl 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 tutype. - Las cargas útiles binarias deben codificarse en
toJSON()base64 (véase eltoBase64asistente 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>