MCP, bir müşteri discover araçlarına izin verir ve onları paylaşılan bir protokolle çağırır. FlashData, Google Search ve YouTube veri araçları uzaktan akışlı bir HTTP uç noktası ile ortaya çıkıyor. Bu öğretici bir Node.js müşteriyi bağlar, mevcut araç tanımlarını listeler ve açıkça etkinleştirdiğinizde bir aramayı çalışır.
Bu bir protokol entegrasyon kılavuzudur. Sıradan Python işlevleri bir ajan çerçevesi ile kayıt olmak istiyorsanız, kullanın Google ve YouTube arama araçları bir AI ajanına ekleyin.
SDK'u yükleyin ve sunucudaki API anahtarını tut.
Node.js 22 veya daha sonra kullanın. Örneğin resmi MCP SDK sürümünü zaten FlashData dokümanında doğrulandı. API anahtarını bir sunucu ortamında tut; bir tarayıcı paketinde gömmeyin, kamu havuzu veya MCP uç noktası URL.
mkdir flashdata-mcp-client
cd flashdata-mcp-client
npm init -y
npm install @modelcontextprotocol/[email protected]
export FLASHDATA_API_KEY='your-api-key'
Son nokta ise https://data.flashdata.dev/mcp. Kimlik doğrulama kullanır X-API-Key Başlık. Yerel bir FlashData sunucusuna başlamanız gerekmez. Bu bağlantı, Streamable HTTP'u kullanıyor, bir aptal komut değil.
Connect, denetim araçları ve opsiyonel olarak bir arama
Bu dosyayı bu dosyayı kurtarmak olarak mcp-search.mjs. Varsayılan olarak, aramalar listTools() Mevcut araç isimlerini ve Google Search giriş şemasını yazdırın. Keşfet araçları ücretli bir veri sorgusu uygulamaz.
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 argümanları düzeliyor
REST ve MCP, farklı istek şekilleri ile aynı arama görevini tanımlamaktadır. Bir REST sorgusu ülke ve dil kontrolleri içeride params. Bir MCP aracı alır gl, hl, num Ve ve page Doğrudan doğrudan içeride arguments; bir REST göndermeyin params MCP aracına itiraz edin. Bilinmeyen alanlar reddedilir.
YouTube için, bir çağrı inşa etmeden önce araç şemasını kontrol edin. Bir transkript aracı alır video_id, language Ve ve auto; auto Mevcut otomatik veya yükleyici-provided pisti seçin. Onları eksik olan bir video için kuyruklar yaratmaz.
Asynchronous işler ve büyük sonuçlar
Use Use Use mode: "async" Gerçek bir zaman sonucu yerine bir iş makbuz istiyorsanız. Geri döndü iş ID'u tut ve onu geçmek job_id To to to to için get_job. Tamamlanan işler, orijinal cevabı içerir output; Sonuçlar tamamlandıktan sonra 24 saatleri için muhafaza edilir. Bir iş okumak, sorguyu tekrar göndermez.
Büyük sonuçlar JSON text chunk olarak gelebilir result_id Ve ve next_offset. Call Call Çağrı get_result Aynı anahtarla birlikte ve geri dönüşü kullanmaya devam et next_offset Is is is is Is is Is Is is'dir. null. Parsing'den önce sipariş edilen kıkırıklar. Limit UTF-In ölçüldü16 Kod birimleri, satırlar veya küller değil. Sonuç önbellek 10 dakika, anahtar başına en fazla dört büyük sonuçta tutar ve daha erken evlenebilir sonuçlar verir.
Video veya sesinizi depolamanıza sunmak için, çağrı youtube_download Biriyle birlikte storage Hedef ve API anahtar youtube_download'u verir. Geri döndü iş ID ve anket get_job. Dosya tabanlı Bulk işleme için, kullanın Bulk işleme API’si.
Ne olduğuna göre başarısızlıkları tedavi et
Başarılı bir HTTP değişimi hala bir araç sonucu içerebilir isError: true; bu alanı kontrol edin. Tool hataları faydalı upstream durumunu korur ve tanımlayıcılar talep eder. Tekrar denemeden önce geçersiz argümanlar, izinler veya kredi dengesi.
Zaman aşımı veya bağlantı kaybı sorgunun çalıştırılmadığını kanıtlamaz. Şu durumda query_outcome_unknown, yeniden göndermeden önce Request History bölümünü inceleyin. Bu istemci ücretli araç çağrılarını otomatik olarak tekrar denemez. Üst sistem yanıtları 4 MiB ile sınırlıdır; bu nedenle az sayıda sonuçla başlayın.
Queries mevcut kredilerinizi fiyatlandırmanızı kullanır, ek MCP şarjı olmadan. Okumayı Oku MCP referans, MCP genel bakış Ve ve Fiyat fiyatlandırma Bir üretim müşterisi için koncurrency veya toplu boyutları seçmeden önce.