MCP はクライアント discover ツールを割り当て、共有プロトコルを介して呼び出します。 FlashData は、Google Search と YouTube のデータツールをリモート・ストリーム可能な HTTP エンドポイントで公開します。 このチュートリアルでは、Node.jsクライアントを接続し、利用可能なツールの定義を一覧表示し、明示的に有効化したときにのみ検索を実行します。
これはプロトコル統合ガイドです。 通常の Python 関数をエージェントフレームワークに登録したい場合、 GoogleとYouTubeの検索ツールをAIエージェントに追加.
SDKをインストールし、APIキーをサーバーに保存します。
Node.js 22 以上を使用してください。 例では、FlashData ドキュメントで既に検証済みの公式 MCP SDK 版を使用しています。 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サーバを起動する必要はありません。 この接続は、stdioコマンドではなく、HTTPをストリーム可能にします。
接続、検査ツール、オプションで1つの検索を実行
このファイルを保存する 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; REST を送信しない 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分を持続し、キーごとに4つの大きな結果を保持し、結果をすぐに回避することができます。
ビデオやオーディオをストレージに配信するには、電話 youtube_download とりあえ storage youtube_downloadを付与するAPIキーと宛先。 返されたジョブの保存 ID と poll get_job. ファイルベースのBulk処理のために、使用して下さい Bulk 処理 API.
何が起こったかに従って失敗を扱います
HTTP交換が成功すると、ツール結果が付いても使用できます。 isError: true; そのフィールドを確認してください。 ツールのエラーは、有用な上流のステータスと識別子を保持します。 無効な引数、パーミッション、またはクレジット残高を再度試行する前に修正します。
タイムアウトや紛失した接続は、クエリが実行されていないことを証明しません。 のために query_outcome_unknown, 、再登録の前に要求Historyを点検して下さい。 このクライアントは、有料のツールコールの周りの自動リトライループを持っていません。 4 MiB には、大きなアップストリーム応答が限られているため、小さな結果カウントで開始します。
Queries は既存のクレジット価格設定を使用し、MCP の追加料金は使用しません。 読む MCP リファレンス, MCPの概要 とりあえず プライシング 生産の顧客のためのconcurrencyかバッチ サイズを選ぶ前に。