MCP позволяет клиенту использовать инструменты discover и вызывать их через общий протокол. FlashData предоставляет инструменты данных Google Search и YouTube с помощью удаленной потоковой конечной точки HTTP. Это руководство соединяет клиент Node.js, перечисляет доступные определения инструментов и запускает поиск только тогда, когда вы явно включите его.
Это руководство по интеграции протоколов. Если вы хотите, чтобы обычные функции Python регистрировались с помощью фреймворка агента, используйте Добавьте инструменты поиска Google и YouTube к агенту ИИ.
Установите SDK и сохраните ключ API на сервере.
Используйте Node.js 22 или более поздней версии. В примере используется официальная версия MCP SDK, уже проверенная в документации FlashData. Храните ключ API в серверной среде; не встраивайте его в пакет браузера, публичное хранилище или конечную точку MCP URL.
mkdir flashdata-mcp-client
cd flashdata-mcp-client
npm init -y
npm install @modelcontextprotocol/[email protected]
export FLASHDATA_API_KEY='your-api-key'
Конечная точка - это https://data.flashdata.dev/mcp. Аутентификация использует X-API-Key Заголовок. Вам не нужно запускать локальный сервер FlashData. Это соединение использует потоковый HTTP, а не команду stdio.
Подключите, проверьте инструменты и опционально запустите один поиск
Сохранить этот файл как mcp-search.mjs. По умолчанию он вызывает listTools() и печатает доступные имена инструментов и схему ввода Google Search. Инструменты обнаружения не выполняют платный запрос данных.
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 плоские
REST и MCP описывают одну и ту же поисковую задачу с различными формами запросов. Запрос REST помещает внутри страны и языковой контроль params. Инструмент MCP получает gl, hl, num и page непосредственно в arguments; Не посылайте отдыхать params Отзывы об инструменте MCP. Неизвестные поля отклоняются.
Для YouTube проверьте схему инструмента перед построением вызова. Инструмент транскрипции принимает video_id, language и auto; auto Выберите существующую автоматическую или загрузочную дорожку. Он не генерирует подписи к видео, в котором их нет.
Обработка асинхронных заданий и больших результатов
Использовать mode: "async" Если вы хотите получить квитанцию о приеме на работу вместо результата в реальном времени. Держите возвращенную работу ID и передайте ее как job_id то get_job. Завершенные задания включают в себя первоначальный ответ на output; Результаты сохраняются для 24 через несколько часов после завершения. Чтение работы не отправляет запрос снова.
Большие результаты могут прийти в виде текстового фрагмента JSON с result_id и next_offset. Звони get_result с тем же ключом и продолжать использовать возвращенное смещение до тех пор, пока next_offset Это null. Сопоставьте куски по порядку перед разбором. Предел измеряется в единицах кода UTF-16, а не в строках или байтах. Кэш результата длится 10 минуты, имеет максимум четыре больших результата на ключ и может выселить результаты раньше.
Чтобы доставить видео или аудио на ваше хранилище, позвоните youtube_download с а storage пункт назначения и ключ API, который предоставляет youtube_download. Сохранить возвращенную работу ID и опрос get_job. Для обработки Bulk на основе файлов используйте API обработки Bulk.
Относитесь к неудачам в соответствии с тем, что произошло
Успешная биржа HTTP может по-прежнему содержать результат инструмента с помощью isError: true; Проверьте это поле. Ошибки в инструментах сохраняют полезный статус upstream и идентификаторы запросов. Исправьте недействительные аргументы, разрешения или кредитный баланс, прежде чем пытаться снова.
Тайм-аут или потерянное соединение не доказывает, что запрос не был выполнен. Для query_outcome_unknown, Проверить запрос History перед повторной отправкой. Этот клиент намеренно не имеет автоматической петли повторного использования вокруг платного вызова инструмента. Большие отклики выше по течению ограничены 4 MiB, поэтому начните с небольшого количества результатов.
Запросы используют существующую стоимость кредитов без дополнительной платы MCP. Прочитай. Ссылка на MCP, Обзор MCP и цена перед тем, как выбрать для производственного клиента параллельные или пакетные размеры.