MCP consente a un client di utilizzare gli strumenti discover e di chiamarli tramite un protocollo condiviso. FlashData espone gli strumenti di dati Google Search e YouTube attraverso un endpoint remoto Streamable HTTP. Questo tutorial collega un client Node.js, elenca le definizioni degli strumenti disponibili, ed esegue una ricerca solo quando lo si abilita esplicitamente.
Questa è una guida di integrazione del protocollo. Se si desidera che le normali funzioni Python registrino con un quadro agente, utilizzare Aggiungi strumenti di ricerca Google e YouTube a un agente AI.
Installare lo SDK e mantenere il tasto API sul server
Utilizzare Node.js 22 o versioni successive. L'esempio utilizza la versione ufficiale MCP SDK già verificata nella documentazione FlashData. Mantenere il tasto API in un ambiente server; non incorporarlo in un pacchetto di browser, repository pubblico o MCP endpoint URL.
mkdir flashdata-mcp-client
cd flashdata-mcp-client
npm init -y
npm install @modelcontextprotocol/[email protected]
export FLASHDATA_API_KEY='your-api-key'
Il punto finale è https://data.flashdata.dev/mcp. L'autenticazione utilizza X-API-Key Intestazione. Non è necessario avviare un server FlashData locale. Questa connessione utilizza Streamable HTTP, non un comando stdio.
Collegare, ispezionare gli strumenti e eseguire facoltativamente una ricerca
Salvare questo file come mcp-search.mjs. Per impostazione predefinita chiama listTools() e stampa i nomi degli strumenti disponibili e lo schema di input di ricerca Google. L'individuazione degli strumenti non esegue una query dei dati pagati.
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const key = process.env.FLASHDATA_API_KEY;
if (!key) throw new Error("Set FLASHDATA_API_KEY first.");
const client = new Client({ name: "search-example", version: "1.0.0" });
try {
await client.connect(new StreamableHTTPClientTransport(
new URL("https://data.flashdata.dev/mcp"),
{ requestInit: { headers: { "X-API-Key": key } } },
));
const { tools } = await client.listTools();
console.log("Available tools:", tools.map(tool => tool.name));
const search = tools.find(tool => tool.name === "google_search");
if (!search) throw new Error("google_search is not available to this client.");
console.log("Search input schema:", JSON.stringify(search.inputSchema, null, 2));
if (process.env.RUN_SEARCH === "1") {
const result = await client.callTool({
name: "google_search",
arguments: { query: process.env.SEARCH_QUERY ?? "MCP protocol",
gl: "us", hl: "en", num: 3, page: 1, mode: "realtime" },
});
if (result.isError) {
console.error(JSON.stringify(result, null, 2));
process.exitCode = 1;
} else {
console.log(JSON.stringify(result, null, 2));
}
} else {
console.log("Discovery complete. Set RUN_SEARCH=1 to submit a billable query.");
}
} finally {
await client.close();
}
node mcp-search.mjs
# Run only when you are ready to submit a search using account Credits:
RUN_SEARCH=1 SEARCH_QUERY='MCP protocol' node mcp-search.mjs
Gli argomenti MCP sono piatti
REST e MCP descrivono lo stesso compito di ricerca con diverse forme di richiesta. Una query REST pone i controlli del paese e della lingua all'interno params. Riceve uno strumento MCP gl, hl, num e page direttamente in arguments; non inviare un REST params oggetti allo strumento MCP. I campi sconosciuti sono respinti.
Per YouTube, ispezionare lo schema dello strumento prima di costruire una chiamata. Uno strumento di trascrizione richiede video_id, language e auto; auto seleziona la traccia automatica o di uploader già esistente. Non genera didascalie per un video che li manca.
Maneggiare lavori asincroni e risultati grandi
Uso mode: "async" quando si desidera una ricevuta di lavoro invece di un risultato in tempo reale. Mantenere il lavoro restituito ID e passarlo come job_id a get_job. I lavori completi includono la risposta originale in output; i risultati sono conservati per 24 ore dopo il completamento. Leggere un lavoro non invia di nuovo la query.
Grandi risultati possono arrivare come un testo JSON con result_id e next_offset. Chiamata get_result con la stessa chiave e continuare a utilizzare l'offset restituito fino a next_offset è null. Concatena i pezzi in ordine prima di parsing. Il limite è misurato in unità di codice UTF-16, non righe o byte. La cache dei risultati dura 10 minuti, detiene al massimo quattro grandi risultati per chiave, e può espellere i risultati prima.
Per fornire video o audio al tuo storage, chiama youtube_download con un storage destinazione e chiave API che garantisce youtube_download. Salvare il lavoro restituito ID e sondaggio get_job. Per l'elaborazione Bulk basata su file, utilizzare il API di elaborazione Bulk.
Trattare fallimenti secondo ciò che è successo
Uno scambio di successo HTTP può ancora contenere un risultato di strumento isError: true; controlla quel campo. Gli errori degli strumenti mantengono lo stato utile a monte e gli identificatori di richiesta. Fissare argomenti, autorizzazioni o saldo di credito non validi prima di provare di nuovo.
Una connessione timeout o persa non dimostra che una query non è stata eseguita. Per query_outcome_unknown, ispeziona richiesta History prima di risottomettere. Questo cliente deliberatamente non ha un loop di riprovazione automatico intorno a una chiamata a pagamento. Le grandi risposte a monte sono limitate a 4 MiB, quindi inizia con un piccolo numero di risultati.
Le query utilizzano il prezzo dei crediti esistenti, senza costi aggiuntivi di MCP. Leggi il testo Riferimento MCP, Panoramica MCP e prezzi prima di scegliere le dimensioni concurrency o batch per un cliente di produzione.