0Pricing
MCP Academy · Pelajaran

Menambahkan Alat Sapaan

Hiasi fungsi Python agar dapat dipanggil oleh kecerdasan buatan.

Menambahkan Alat Sapaan 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.

Beri Server Anda Kemampuan

Server tanpa tool hanyalah cangkang. tool adalah fungsi Python yang dapat dipanggil AI untuk benar-benar melakukan sesuatu bagi pengguna. 🛠️

Dekorator Ajaib

FastMCP mengekspos sebuah fungsi sebagai tool dengan satu baris: dekorator @mcp.tool() yang ditempatkan tepat di atas definisi fungsi Anda.

@mcp.tool()
def hello():
    ...

Tulis Fungsi Biasa

Isinya hanyalah Python. Tidak ada kode protokol khusus atau JSON yang perlu ditulis secara manual. Anda cukup menulis tindakan tool tersebut dan mengembalikan suatu nilai.

@mcp.tool()
def hello():
    return "Hello from MCP!"

Tambahkan Parameter

Tool menjadi lebih berguna jika menerima masukan. Tambahkan parameter, lalu model dapat meneruskan nilai saat memutuskan untuk memanggil tool Anda.

@mcp.tool()
def greet(name):
    return "Hello, " + name

Petunjuk Tipe Membentuk Skema

Tambahkan petunjuk tipe seperti name: str, lalu FastMCP mengubahnya menjadi skema masukan. Dengan demikian, model mengetahui jenis nilai yang harus dikirim.

@mcp.tool()
def greet(name: str) -> str:
    return "Hello, " + name

Docstring Menjadi Deskripsi

Docstring fungsi Anda menjadi deskripsi tool. Model membacanya untuk menentukan kapan tool ini tepat digunakan.

@mcp.tool()
def greet(name: str) -> str:
    """Greet a person by name."""
    return "Hello, " + name

Nama Diambil dari Fungsi

Secara bawaan, nama tool adalah nama fungsi. Jadi, def greet menerbitkan tool yang dicantumkan klien sebagai "greet".

Kembalikan Teks Biasa

Untuk tool pertama, cukup kembalikan sebuah string. FastMCP membungkusnya ke dalam bentuk hasil MCP yang sesuai agar klien menerima teks yang bersih.

Jelaskan dengan Baik

Pemilihan kata yang baik itu penting: deskripsi yang jelas membantu model memilih tool Anda pada saat yang tepat. Docstring yang samar dapat menyebabkan pemanggilan terlewat.

Terdaftar Secara Otomatis

Anda tidak perlu memanggil fungsi pendaftaran sendiri. Hanya dengan menambahkan dekorator, tool tersebut terdaftar pada instans mcp dan siap ditawarkan.

Tambahkan Sebanyak yang Anda Perlukan

Satu server dapat memuat banyak tool. Cukup tambahkan dekorator pada setiap fungsi, lalu semuanya akan muncul ketika klien menanyakan apa saja yang tersedia.

Pemeriksaan Singkat

Dari mana deskripsi sebuah tool berasal?

Rangkuman

Anda telah menambahkan tool dengan @mcp.tool(), memberinya parameter bertipe, dan membiarkan docstring menjelaskannya. Server Anda akhirnya dapat melakukan sesuatu. Sekarang mari jalankan! ✨

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Menambahkan Alat Sapaan” gratis?

Ya — teks lengkap “Menambahkan Alat Sapaan” 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 “Menambahkan Alat Sapaan”?

Hiasi fungsi Python agar dapat dipanggil oleh kecerdasan buatan. 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 “Menambahkan Alat Sapaan” 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

  1. Membuat Instans FastMCP
  2. Menambahkan Alat Sapaan
  3. Menjalankan Server dengan stdio
  4. Memastikan Server Memuat dan Mencantumkan Alat
← Kembali ke MCP Academy