Arsitektur Server Berlapis
Pisahkan transportasi, penangan, dan logika bisnis.
Arsitektur Server Berlapis adalah pelajaran MCP Academy gratis di CoddyKit. Ini adalah pelajaran 1 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.
Mengapa Satu File Besar Menyulitkan
Server yang dijejalkan ke satu file mencampur transportasi, logika tool, dan pemanggilan data. Seiring bertambah besar, setiap perubahan berisiko merusak sesuatu yang jauh dari lokasi perubahan.
Berpikir dalam Lapisan
Server yang rapi terbagi menjadi lapisan: transportasi di tepi, penangan MCP di tengah, dan logika bisnis murni di bawahnya.
Lapisan Transportasi
Lapisan transportasi luar hanya memindahkan pesan melalui stdio atau HTTP. Lapisan ini tidak boleh mengetahui apa yang sebenarnya dilakukan tool Anda.
Penangan adalah Adaptor Tipis
Penangan tool dan resource Anda harus tipis: mengurai argumen, memanggil layanan, lalu membentuk hasil. Simpan pekerjaan sebenarnya di luar penangan tersebut.
@mcp.tool()
def summarize(text: str) -> str:
return service.summarize(text)Lapisan Layanan yang Melakukan Pekerjaan
Letakkan logika sebenarnya dalam modul layanan biasa tanpa impor MCP. Modul ini hanyalah Python normal yang dapat Anda panggil dari mana saja.
def summarize(text: str) -> str:
return shorten(clean(text))Manfaat Pemisahan
Dengan logika yang dipisahkan dari MCP, Anda dapat melakukan pengujian tanpa menjalankan server, lalu menggunakannya kembali dalam CLI atau aplikasi web nantinya.
Dependensi Mengarah ke Dalam
Pertahankan aturan satu arah: penangan boleh mengimpor layanan, tetapi layanan tidak boleh mengimpor penangan atau transportasi di atasnya.
Satu Folder untuk Setiap Urusan
Petakan lapisan ke folder agar struktur menjelaskan susunannya: entri server, penangan, layanan, dan model masing-masing memiliki tempat sendiri.
src/
server.py
handlers/
services/
models.pyDaftarkan, Jangan Definisikan, di Entri
server.py Anda harus menghubungkan penangan ke instans FastMCP, bukan berisi logika. File ini adalah titik perakitan, bukan pelaksana pekerjaan.
from handlers import register_tools
register_tools(mcp)Helper Lintas Urusan Tetap Bersama
Logging, konfigurasi, dan validasi adalah urusan bersama. Berikan modul umum agar setiap lapisan menggunakan helper yang sama.
Berkembang Tanpa Menulis Ulang
Pelapisan memungkinkan server bertambah besar: tambahkan tool baru dengan menambahkan penangan dan layanan, sementara bagian lainnya tetap tidak tersentuh.
Pemeriksaan Singkat
Di mana logika bisnis sebenarnya dari sebuah tool seharusnya berada?
Ringkasan: Desain Berlapis
Pisahkan server Anda menjadi transportasi, penangan tipis, dan layanan murni, dengan dependensi yang mengarah ke dalam. Berikutnya: konfigurasi. 🧱
Pertanyaan yang Sering Diajukan
Apakah pelajaran “Arsitektur Server Berlapis” gratis?
Ya — teks lengkap “Arsitektur Server Berlapis” 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 “Arsitektur Server Berlapis”?
Pisahkan transportasi, penangan, dan logika bisnis. 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 1 dari 4.
Berapa lama pelajaran “Arsitektur Server Berlapis” 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
- Arsitektur Server Berlapis
- Konfigurasi dan Rahasia melalui Lingkungan
- Alat Idempoten yang Memperhatikan Efek Samping
- Pembuatan Versi Alat dan Skema