MCP Academy · Pelajaran

Alat Kalkulator dari Awal hingga Selesai

Bangun alat aritmetika yang kecil tetapi lengkap.

Pelajaran 4 dari 413 langkah

Alat Kalkulator dari Awal hingga Selesai adalah pelajaran MCP Academy gratis di CoddyKit. Ini adalah pelajaran 4 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.

Membuat Satu Tool Lengkap

Mari gabungkan semuanya menjadi satu tool kalkulator kecil, mulai dari nama yang jelas hingga hasil bersih yang dapat dipercaya model. 🧮

Mulai dengan Server

Pertama, buat instans FastMCP untuk menampung tool. Berikan nama agar klien dapat mengenali server Anda.

from mcp.server.fastmcp import FastMCP
mcp = FastMCP("calculator")

Namai Operasi

Pilih nama yang tepat. Kita akan menjumlahkan dua angka, jadi fungsi add mudah dipahami oleh Anda maupun model.

Deklarasikan Parameter Bertipe

Gunakan petunjuk tipe agar model mengirim angka, bukan teks. Kita menerima dua float agar dapat menangani bilangan desimal maupun bilangan bulat.

def add(a: float, b: float) -> float:
    ...

Tulis Docstring

Docstring menjadi deskripsi, jadi nyatakan dengan jelas fungsi tool dan hal yang dikembalikannya.

def add(a: float, b: float) -> float:
    """Add two numbers and return the sum."""

Jadikan sebagai Tool dengan Dekorator

Tambahkan dekorator tool agar FastMCP mendaftarkan fungsi dan mengiklankannya kepada setiap klien yang terhubung.

@mcp.tool()
def add(a: float, b: float) -> float:
    """Add two numbers."""
    return a + b

Kembalikan Hasil yang Jelas

Mengembalikan jumlahnya memang berfungsi, tetapi hasil berlabel lebih mudah dipahami oleh model dan pengguna yang melihat jawabannya.

    return a + b

Tambahkan Tool Kedua

Satu tool untuk satu tugas, jadi buat tool divide terpisah daripada memasukkan berbagai mode ke dalam add. Masing-masing tetap mudah dipanggil.

@mcp.tool()
def divide(a: float, b: float) -> float:
    return a / b

Lindungi dari Input yang Buruk

Pembagian dengan nol dapat menyebabkan kerusakan, jadi periksa terlebih dahulu dan kembalikan pesan kesalahan yang jelas agar dapat dibaca dan dijelaskan oleh model.

    if b == 0:
        return "Error: cannot divide by zero."

Jalankan Server

Akhiri dengan pemanggilan run agar server dimulai dan mendengarkan klien melalui stdio saat Anda meluncurkan berkas tersebut.

if __name__ == "__main__":
    mcp.run()

Uji Seluruh Alat

Luncurkan server dan biarkan klien mencantumkan alat Anda. Jika add dan divide beserta deskripsinya terlihat, berarti pengaturannya sudah benar.

Pemeriksaan Singkat

Mengapa divide diberi alat tersendiri, bukan tanda mode pada add?

Jawab di pelajaran interaktif

Ringkasan

Anda telah membuat alat kalkulator lengkap: diberi nama dengan jelas, memiliki parameter bertipe, deskripsi docstring, perlindungan terhadap kesalahan, serta hasil yang rapi dan dapat dipercaya oleh model. ✅

Gratis untuk memulai

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

Mulai belajar gratis Lihat kursus lengkapnya

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Alat Kalkulator dari Awal hingga Selesai” gratis?

Ya — teks lengkap “Alat Kalkulator dari Awal hingga Selesai” 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 “Alat Kalkulator dari Awal hingga Selesai”?

Bangun alat aritmetika yang kecil tetapi lengkap. 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 4 dari 4.

Berapa lama pelajaran “Alat Kalkulator dari Awal hingga Selesai” 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

Memberi Nama dan Mendeskripsikan Alat dengan Baik
Mendeklarasikan Parameter dengan Petunjuk Tipe
Mengembalikan Hasil yang Berguna
Alat Kalkulator dari Awal hingga Selesai

← Kembali ke MCP Academy