Mit MCP können Client-Tools von discover über ein gemeinsames Protokoll aufgerufen werden. FlashData stellt Google Search und YouTube Datentools über einen ferngesteuerten Streamable HTTP Endpunkt frei. Dieses Tutorial verbindet einen Node.js-Client, listet die verfügbaren Tooldefinitionen auf und führt eine Suche nur aus, wenn Sie sie explizit aktivieren.
Dies ist ein Protokoll-Integration Guide. Wenn Sie möchten, dass sich gewöhnliche Python-Funktionen mit einem Agent-Framework registrieren lassen, verwenden Sie Hinzufügen von Google und YouTube-Suchtools zu einem AI-Agenten.
Installieren Sie den SDK und behalten Sie den API-Schlüssel auf dem Server
Verwenden Sie Node.js 22 oder höher. Das Beispiel verwendet die offizielle MCP SDK-Version, die bereits in der FlashData-Dokumentation verifiziert wurde. Bewahren Sie den API-Schlüssel in einer Serverumgebung auf; betten Sie ihn nicht in ein Browser-Bundle, ein öffentliches Repository oder den MCP-Endpunkt URL ein.
mkdir flashdata-mcp-client
cd flashdata-mcp-client
npm init -y
npm install @modelcontextprotocol/[email protected]
export FLASHDATA_API_KEY='your-api-key'
Der Endpunkt ist https://data.flashdata.dev/mcp. Die Authentifizierung nutzt die X-API-Key Header. Sie müssen keinen lokalen FlashData-Server starten. Diese Verbindung verwendet Streamable HTTP, keinen Stdio-Befehl.
Verbinden, prüfen Sie Tools und führen Sie optional eine Suche aus
Speichern Sie diese Datei als mcp-search.mjs. Standardmäßig ruft es listTools() und druckt die verfügbaren Werkzeugnamen und das Google Search-Eingabeschema aus. Das Auffinden von Tools führt keine kostenpflichtige Datenabfrage aus.
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
MCP Argumente sind flach
REST und MCP beschreiben dieselbe Suchaufgabe mit unterschiedlichen Anforderungsformen. Eine REST-Abfrage platziert Länder- und Sprachkontrollen innerhalb params. Ein MCP-Tool erhält gl, hl, num und page direkt in arguments; Senden Sie keine REST params Ein Objekt für das MCP-Tool. Unbekannte Felder werden abgelehnt.
Überprüfen Sie für YouTube das Werkzeugschema, bevor Sie einen Aufruf erstellen. Ein Transkript-Tool nimmt video_id, language und auto; auto wählt den vorhandenen automatischen oder vom Uploader bereitgestellten Track aus. Es generiert keine Beschriftungen für ein Video, dem sie fehlen.
Umgang mit asynchronen Jobs und großen Ergebnissen
Verwendung mode: "async" wenn Sie eine Jobquittung anstelle eines Echtzeitergebnisses wünschen. Behalten Sie den zurückgegebenen Job ID und übergeben Sie ihn als job_id bis get_job. Abgeschlossene Jobs beinhalten die ursprüngliche Antwort in output; Ergebnisse werden für 24 Stunden nach Abschluss beibehalten. Beim Lesen eines Jobs wird die Abfrage nicht erneut eingereicht.
Große Ergebnisse können als JSON-Textblock mit result_id und next_offset. Anruf get_result mit dem gleichen Schlüssel und verwenden Sie den zurückgegebenen Offset bis next_offset ist null. Konkatenate Brocken in der Reihenfolge vor dem Parsing. Der Grenzwert wird in UTF-16-Codeeinheiten gemessen, nicht in Zeilen oder Bytes. Der Ergebnis-Cache dauert 10 Minuten, hält maximal vier große Ergebnisse pro Schlüssel und kann die Ergebnisse früher vertreiben.
Um Video oder Audio an Ihren Speicher zu liefern, rufen Sie an youtube_download mit einem storage Ziel und ein API-Schlüssel, der youtube_download gewährt. Speichern Sie den zurückgegebenen Job ID und Umfrage get_job. Für die dateibasierte Bulk-Verarbeitung verwenden Sie die API für Bulk-Verarbeitung.
Behandeln Sie Misserfolge nach dem, was passiert ist
Ein erfolgreicher HTTP-Austausch kann immer noch ein Werkzeugergebnis mit isError: true; Überprüfen Sie dieses Feld. Tool-Fehler behalten nützliche Upstream-Status und Anforderung Identifikatoren. Beheben Sie ungültige Argumente, Berechtigungen oder Guthaben, bevor Sie es erneut versuchen.
Ein Timeout oder eine verlorene Verbindung beweist nicht, dass eine Abfrage nicht ausgeführt wurde. für query_outcome_unknown, inspizieren Anfrage History vor dem erneuten Absenden. Dieser client hat bewusst keine automatische retry-schleife um einen kostenpflichtigen toolanruf. Große Upstream-Antworten sind auf 4 MiB beschränkt, also beginnen Sie mit einer kleinen Ergebniszahl.
Abfragen verwenden Ihre bestehenden Credits-Preise, ohne zusätzliche MCP-Gebühr. Lesen Sie MCP, MCP Übersicht und Preisgestaltung Vor der Auswahl von Parallelitäts- oder Chargengrößen für einen Produktionskunden.