Membungkus API REST sebagai Alat
Ubah titik akhir eksternal menjadi alat yang dapat dipanggil.
Membungkus API REST sebagai Alat adalah pelajaran MCP Academy gratis di CoddyKit. Ini adalah pelajaran 2 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar MCP Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus MCP Academy mencakup 4 pelajaran total.
Ubah Titik Akhir Menjadi Alat
API REST apa pun dapat menjadi alat MCP. Setiap titik akhir menjadi fungsi yang dapat dipanggil model untuk mengambil atau mengirim data. 🌐
Panggil HTTP dari Alat
Di dalam alat, Anda membuat permintaan HTTP biasa, lalu mengembalikan respons sebagai teks yang dapat dibaca dan dipahami model.
Utamakan Klien Asinkron
Gunakan klien asinkron seperti httpx agar panggilan API yang lambat tidak memblokir permintaan lain saat menunggu jaringan.
import httpx
async with httpx.AsyncClient() as client:
r = await client.get(url)Petakan Parameter ke Argumen
Jadikan kueri titik akhir sebagai argumen alat. Model mengirimkan kota atau id, lalu Anda menempatkannya dengan aman ke dalam permintaan.
@mcp.tool()
async def get_weather(city: str) -> str:
...Simpan Rahasia di Sisi Server
Simpan kunci API di lingkungan server Anda, jangan sebagai argumen alat. Model tidak boleh melihat atau mengirim kredensial.
key = os.environ["WEATHER_API_KEY"]Periksa Kode Status
Periksa status HTTP sebelum mempercayai isi respons. Kode 404 atau 500 berarti Anda harus melaporkan kesalahan yang jelas, bukan data sampah.
r.raise_for_status()Urai dan Ringkas JSON
Sebagian besar API mengembalikan JSON. Urai dan kembalikan hanya bidang yang diperlukan tugas agar model tidak dibanjiri informasi yang tidak relevan.
data = r.json()
return data["temp_c"]Berikan Satu Tugas untuk Setiap Alat
Petakan satu titik akhir ke satu alat khusus dengan nama yang jelas. Alat yang terperinci lebih mudah dipilih model dengan tepat.
Tulis Deskripsi yang Membantu
Jelaskan fungsi titik akhir dan kapan harus menggunakannya. Deskripsi yang tepat membantu model mengetahui bahwa alat ini harus dipanggil.
Tangani Kegagalan Jaringan
Bungkus panggilan tersebut agar batas waktu atau terputusnya koneksi mengembalikan pesan kesalahan yang mudah dibaca, bukan membuat seluruh server berhenti.
Tetapkan Batas Waktu yang Wajar
Selalu teruskan batas waktu agar layanan hulu yang macet tidak membekukan alat Anda selamanya saat menunggu balasan yang tidak pernah datang.
r = await client.get(url, timeout=10.0)Pemeriksaan Singkat
Di mana seharusnya kunci API disimpan?
Ringkasan: REST sebagai Alat
Anda telah membungkus titik akhir sebagai alat asinkron: argumen masuk, kunci sisi server, pemeriksaan status, dan JSON yang telah diringkas sebagai keluaran. Berikutnya, gunakan kumpulan koneksi. 🎯
Belajar Python dengan tutor AI — gratis
Tulis dan jalankan kode asli di browser kamu, dapatkan bantuan instan dari tutor AI 24/7, dan lanjutkan di mana kamu tinggalkan di web atau aplikasi.
- Kursus
- 30
- Pelajaran
- 120
Pertanyaan yang Sering Diajukan
Apakah pelajaran “Membungkus API REST sebagai Alat” gratis?
Ya — teks lengkap “Membungkus API REST sebagai Alat” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus MCP Academy, upgrade ke CoddyKit PRO. Kursus MCP Academy mencakup 4 pelajaran total.
Apa yang akan aku pelajari di “Membungkus API REST sebagai Alat”?
Ubah titik akhir eksternal menjadi alat yang dapat dipanggil. Kamu berlatih MCP Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.
Apakah aku perlu pengalaman untuk memulai MCP Academy?
Tidak diperlukan pengalaman sebelumnya. MCP Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 2 dari 4.
Berapa lama pelajaran “Membungkus API REST sebagai Alat” memakan waktu?
Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.
Bisakah aku menulis dan menjalankan kode dalam pelajaran MCP Academy ini?
Ya. Setiap pelajaran MCP Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.
Semua pelajaran dalam kursus ini
- Menyediakan Kueri SQL dengan Aman
- Membungkus API REST sebagai Alat
- Mengumpulkan Koneksi dalam Lifespan
- Menyimpan Cache dan Membatasi Laju Upstream