MCP ให้ลูกค้า discover เครื่องมือและเรียกพวกเขาผ่านขั้นตอนร่วมกัน FlashData เปิดเผย Google Search ถึง YouTube เครื่องมือข้อมูลผ่านทางสายข้อมูลทางไกลName HTTP จุดปลาย บทเรียนนี้เชื่อมโยง Node.js โปรแกรมลูกข่าย, รายการคําจํากัดความของเครื่องมือที่มีอยู่ และทําการค้นหา เมื่อคุณเปิดใช้งานมันโดยตรงเท่านั้น
นี่คือคู่มือการรวมกําลังของโปรโตคอล ถ้าคุณต้องการความสามัญ Python ฟังก์ชันที่จะลงทะเบียนด้วยโครงร่างตัวแทน ใช้ เพิ่ม Google ถึง YouTube เครื่องมือสําหรับค้นหา AI.
ติดตั้ง 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ไม่ใช่คําสั่งสไตร
เชื่อมต่อ, เครื่องมือตรวจสอบ และเลือกใช้การค้นหาหนึ่งรายการ
บันทึกแฟ้มนี้เป็น 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 อธิบายงานเดียวกันด้วยรูปแบบที่ต้องการที่แตกต่างกัน สถาน ที่ ที่ มี การ สอบ ถาม กัน อย่าง กว้าง ขวาง ทั้ง ประเทศ และ ภาษา ซึ่ง ควบคุม อยู่ ภาย ใน params. ขนาด MCP ได้รับเครื่องมือ gl, hl, num ถึง page โดยตรงใน arguments; อย่าส่ง STD params วัตถุที่เครื่องมือ MCP ช่องข้อมูลที่ไม่รู้จักถูกปฏิเสธ
สําหรับ YouTube. ตรวจสอบเครื่องมือ Schema ก่อนการสร้างการโทร เครื่องมือสําเนาที่ใช้ video_id, language ถึง auto; auto เลือกแทร็กเสียงที่ผู้อัปโหลดใช้อยู่อัตโนมัติ หรือส่วนที่อัปโหลดมา มันไม่ได้สร้างคําบรรยายสําหรับวิดีโอที่ขาดมัน
จัด การ กับ งาน ที่ ยาก ลําบาก และ ผล ที่ เกิด ขึ้น มาก
ใช้ mode: "async" เมื่อคุณต้องการใบเสร็จค่างาน แทนที่จะเป็นผลของเวลาจริง เก็บงานคืน ID และส่งมันต่อไป job_id ถึง get_job. งานพิมพ์ที่เสร็จสมบูรณ์แล้ว รวมถึงการตอบกลับเดิมด้วย output; สืบค้นเมื่อ 24 หนึ่งชั่วโมงหลังจากเสร็จ การอ่านงานจะไม่ส่งคําค้นอีกครั้ง
ผลงานใหญ่อาจจะมาถึงเป็น JSON ชิ้นส่วนข้อความ result_id ถึง next_offset. เรียก get_result ด้วยคีย์เดียวกันและยังคงใช้ออฟเซ็ตคืนจนถึง next_offset คือ null เรียงตามลําดับ ก่อนที่จะแยกส่วน ลิมิตถูกวัดใน UTF16 รหัสหน่วย ไม่ใช่แถวหรือไบต์ แคชผลลัพธ์สุดท้าย 10 นาทีเก็บผลส่วนใหญ่สี่ครั้งต่อคีย์ และสามารถขับไล่ผลลัพธ์ได้เร็วขึ้น
การที่จะส่งวิดีโอหรือเสียงไปยังที่เก็บของคุณ การโทร youtube_download ด้วย storage จุดหมายปลายทางและ API กุญแจที่อนุญาตให้ใช้ youtube_download. บันทึกงานที่คืนแล้ว ID และผลสํารวจ get_job. สําหรับแฟ้ม Bulk ประมวลผล ใช้ API ประมวลผล Bulk.
การ รักษา ล้ม เหลว ตาม สิ่ง ที่ เกิด ขึ้น
สําเร็จ HTTP การแลกเปลี่ยนยังคงบรรจุผลลัพธ์เครื่องมือด้วย isError: true; เช็กสนามสิ การแจ้งข้อผิดพลาดของเครื่องมือยังคงมีประโยชน์ต่อสถานะการไหลขึ้น และร้องขอตัวระบุข้อมูล แก้ไขอาร์กิวเมนต์ไม่ถูกต้อง, สิทธิ์ที่อนุญาตหรือค่าสําเร็จ ก่อนที่จะลองใหม่
การเชื่อมต่อที่หมดเวลาหรือสูญหาย ไม่ได้พิสูจน์ว่าการสอบถามไม่ได้ถูกประมวลผล สําหรับ query_outcome_unknown, สืบค้นเมื่อขอ History ก่อนทําการเปลี่ยนชื่อใหม่ ลูกความคนนี้จงใจไม่ให้มีการวนซ้ําโดยอัตโนมัติ รอบการเรียกเครื่องมือจ่าย การตอบรับของสายน้ําขนาดใหญ่ จํากัด อยู่ที่ 4 MiB ดังนั้นเริ่มจากจํานวนผลเล็กน้อย
ความ สุข มี อยู่ พร้อม สําหรับ คุณ MCP ค่าใช้จ่าย. อ่าน MCP อ้างอิง, MCP ภาพรวม ถึง ค่าเบี่ยงเบนมาตรฐาน ก่อนที่จะเลือกความต่อเนื่องหรือขนาดชุดสําหรับลูกค้าการผลิต