MCP cho phép một khách hàng discover công cụ và gọi chúng thông qua một giao thức chung. FlashData Hiển thị Google Search và YouTube Công cụ dữ liệu thông qua một luồng từ xa HTTP điểm cuối. Điều này hướng dẫn kết nối một Node.js trạm khách, liệt kê các định nghĩa công cụ sẵn sàng, và chạy tìm kiếm chỉ khi bạn bật nó một cách rõ ràng.
Đây là hướng dẫn phối hợp giao thức. Nếu bạn muốn bình thường Python chức năng để ghi nhớ với một khuôn khổ tác nhân, sử dụng Thêm Google và YouTube Công cụ tìm kiếm cho một tác nhân AI.
Cài đặt SDK và giữ lại API Phím trên máy phục vụ
Dùng Node.js 22 hay sau này. Ví dụ này dùng quan chức MCP SDK phiên bản đã được kiểm tra trong FlashData Tài liệu. Giữ lại API Phím trong môi trường máy chủ; đừng để nó trong gói trình duyệt, kho phần mềm công cộng hoặc MCP điểm kết thúc URL.
mkdir flashdata-mcp-client
cd flashdata-mcp-client
npm init -y
npm install @modelcontextprotocol/[email protected]
export FLASHDATA_API_KEY='your-api-key'
Điểm kết thúc là https://data.flashdata.dev/mcp. Xác thực sử dụng X-API-Key Đầu trang. Bạn không cần phải bắt đầu một địa phương FlashData máy chủ. Name HTTPKhông phải chỉ huy.
Kết nối, thanh tra công cụ và tùy chọn chạy một tìm kiếm
Lưu tập tin này dạng mcp-search.mjs. Theo mặc định, nó gọi listTools() và in các tên công cụ sẵn sàng và các Google Search nhập schema. Phát hiện công cụ không thực hiện một truy vấn dữ liệu được trả tiền.
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 đối số là phẳng
ĐỂ ĐỂ TRONG VÀ MCP Mô tả cùng một công việc tìm kiếm với các hình yêu cầu khác nhau. MỘT CÂU HỎI ROR đặt quốc gia và ngôn ngữ điều khiển bên trong params. An MCP công cụ nhận gl, hl, num và page trực tiếp vào arguments; không gửi một RORT params đối tượng đến công cụ MCP. Các trường không rõ bị từ chối.
Đối với YouTube, thanh tra các công cụ kê trước khi thiết lập một cuộc gọi. Một công cụ ghi chép lấy video_id, language và auto; auto chọn đường dẫn tự động hoặc tải lên. Nó không tạo ra phụ đề cho một video thiếu chúng.
Xử lý các công việc không chặt chẽ và kết quả lớn
Dùng mode: "async" Khi anh muốn biên lai việc làm thay vì kết quả thời gian thực. Giữ lại công việc đã hoàn trả ID Và chuyển nó đi như job_id phải get_job. Công việc hoàn thành bao gồm phản ứng gốc trong output; kết quả được giữ lại 24 hàng giờ sau khi hoàn thành. Đọc tác vụ không đệ trình truy vấn lần nữa.
Kết quả lớn có thể đến như một JSON đoạn văn bản có result_id và next_offset. nhỏ get_result với cùng chìa khóa và tiếp tục sử dụng bù đắp trả về cho đến khi next_offset là null. Phân hủy các mảng trước khi phân. Giới hạn được đo bằng UTF-16 Các đơn vị mã, không phải hàng hoặc byte. Bộ nhớ tạm kết quả cuối cùng 10 phút, cứ mỗi giây thì có bốn kết quả lớn, và có thể xua đuổi kết quả càng sớm càng tốt.
Để giao video hoặc âm thanh đến kho của bạn, cuộc gọi youtube_download với một storage đích lưu trữ và khóa API có quyền youtube_download. Lưu ID tác vụ được trả về rồi kiểm tra định kỳ get_job. Cho các tập tin dựa trên Bulk xử lý, sử dụng API xử lý Bulk.
Xử lý thất bại theo những gì đã xảy ra
Một thành công HTTP trao đổi vẫn có thể chứa một kết quả công cụ với isError: true; kiểm tra cánh đồng đó. Lỗi công cụ giữ lại trạng thái ngược dòng và yêu cầu nhận diện. Sửa đổi đối số không hợp lệ, quyền hạn hoặc sự số dư tín dụng trước khi thử lại.
Thời hạn hoặc sự kết nối bị mất không chứng minh một yêu cầu đã không được thực hiện. Vì query_outcome_unknown, Thanh tra yêu cầu History Trước khi phục hồi. Khách hàng này cố tình không có vòng lặp tự động xung quanh một cuộc gọi công cụ trả tiền. Các phản ứng ngược dòng lớn chỉ giới hạn 4 MiB, hãy bắt đầu với một kết quả nhỏ.
Hàng loạt người sử dụng nguồn tín dụng hiện có của bạn, mà không có thêm MCP sạc. Đọc Tham khảo MCP, Tổng quát MCP và giá trị trước khi chọn kích cỡ đồng thuận hay hàng loạt cho một khách hàng sản xuất.